1.4 KiB
1.4 KiB
Prüfe geschriebene Sections eines Lern-Guides zum Thema "{topic}" (Format: {format_name}) auf Lesbarkeit. Zielgruppe: Anfänger.
SECTION-SPEZIFIKATION (Soll-Zustand): {spec}
SECTIONS: {sections}
Prüfe jede Section:
- Lehrt die Section das Konzept für einen Anfänger ohne Vorwissen verständlich — ordnet sie es ein, erklärt sie das Wie/Warum, macht ein Beispiel es konkret? Nicht so verdichtet, dass nur jemand sie versteht, der das Thema schon kennt.
- Lesbarkeit (echte Mängel notieren):
- Sätze über ~25 Wörter oder Schachtelsätze mit mehreren Einschüben.
- Eine Aufzählung (Schritte/Optionen/Anforderungen) als langer Fließtext-Satz, die eine Markdown-Liste sein sollte.
- Textwand: ein dichter Block ohne Absätze, der sich in mehrere teilen ließe.
- Mehr als ~4 neue Fachbegriffe ohne Erklärung beim ersten Auftreten.
- Sind die Beispiele kurz, simpel, plausibel korrekt — und im themengerechten Format laut Spezifikation (kein Codeblock um Prosa-Beispiele, kein Prosa-Pseudo-Beispiel, wo Code gefragt ist)?
- Ist das Markdown sauber (keine abgebrochenen Code-Blöcke, keine Platzhalter, kein Fremdtext)?
Du PRÜFST nur und notierst Probleme — du änderst nichts. Nur echte Mängel notieren, keine Geschmacksfragen.
Schreibe NUR die JSON-Datei nach: {out_path}
Format — alles in Ordnung: {{"ok": true}} Sonst (Section-Titel EXAKT wie oben): {{"probleme": [{{"section": "Exakter Section-Titel", "problem": "…"}}]}} {extra}