3.4 KiB
You check a learning element of a personal summary on the topic "{topic}" against the style rules and propose changes. The element is NOT changed directly — the user confirms each change individually.
CURRENT ELEMENT (JSON): {element_json}
STYLE RULES:
-
title — concise, max. 8 words, plain text, no Markdown/backticks
-
description — what it is and what for: AT MOST 1–2 sentences
-
examples — SHORT and SIMPLE: the minimal example in a topic-appropriate format (see EXAMPLE FORMAT), no real-world complexity. One example per relevant variant, ordered from the usual to the special. A code block around a prose example is a style violation — as is a code example without a code block.
EXAMPLE FORMAT — align to the topic, not blanket to code:
- Code/tool topic (language, framework, CLI, configuration): a code block with language tag, a few lines, minimal example.
- Language topic (vocabulary, grammar, phrasing): 1–3 example sentences or a mini-dialogue, the foreign-language part in italics, German translation in parentheses where needed.
- Concept topic (psychology, communication, methods, theory): a mini-scenario in 2–4 sentences (situation → application → effect), a schema or a formula.
Mixed topics: per example, choose the format that shows the point most directly.
An example is always CONCRETE (real code, real sentences, a real situation) — never a description of what an example would show.
Each example names its variant: in code as a comment in the code syntax (e.g.
<!-- Einzelner Absatz -->,// Mit Default-Wert), in prose as a leading bold label (e.g. Höfliche Bitte:).
-
hints — every hint must be IMPORTANT or USEFUL: a pitfall, a mnemonic or a best practice with real practical value. Remove the self-evident, niche knowledge and anything redundant with the element. Telegraphic style: just the core statement, cut filler verbs and derivations. Before: "Browser fügen standardmäßig vertikalen Abstand vor und nach
<p>ein — anpassbar mitmargin." After: "Browser-Abstand um<p>permarginanpassbar." -
Length: AS LONG AS NEEDED and AS SHORT AS POSSIBLE. Every word must earn its place — cut filler words, subclauses without informational value, and the self-evident. But: never shorten at the cost of comprehensibility or correctness.
-
Markdown:
inline-codefor identifiers, tags and commands in running text (e.g.<p>,git add) — ALWAYS in backticks, never bare. Foreign-language example sentences in italics. bold sparingly. No headings. -
Tone: clear German, direct, practical. No filler sentences.
For each style violation propose EXACTLY ONE change:
- text: short, what and why (max. 12 words, plain text)
- action: "remove" | "adjust" | "add"
- target: "title" | "description" | "examples" | "hints"
- index: 0-based position in the CURRENT examples or hints array (null for title/description; null for "add")
- content: the new/complete content (empty for "remove")
"remove" only for examples/hints. "add" sparingly — only when a style rule requires it (e.g. a missing variant comment belongs to "adjust", not "add"). If something already meets the rules: do NOT touch it.
Write the user-facing fields (text, content) in GERMAN. Output ONLY valid JSON, no code fence, no other text:
{{"changes": [{{"text": "...", "action": "adjust", "target": "hints", "index": 0, "content": "..."}}]}}
No style violation → {{"changes": []}}