name: prose-editing description: Schneiden und Formen von schriftlichen Arbeiten: Dokumentationen, Runbooks, READMEs, Berichte, Prompts und Anleitungen für Modelle. Verwenden beim Bearbeiten oder Prüfen von Prosa, wenn ein Entwurf ausufernd oder vage ist, oder bevor schriftliche Arbeiten veröffentlicht werden.
Was macht Prosa-Lektorat?
Geht von korrekten Fakten aus. Es geht um die Worte und die Form, nicht um die Fakten. NOTES.md neben dieser Datei enthält ausgearbeitete Beispiele.
Der Test
Jeder Satz sagt dem Leser, was er tun soll, was er erwarten kann oder was passiert, wenn er es falsch macht; streiche einen Satz, der nichts davon tut. Prägnanz ist nicht Kürze: Schneide niemals Substanz weg, um eine Länge zu erreichen, sondern das Gerüst darum herum.
Streichen
- Hüsteln. Setze die Substanz in den ersten Satz.
- Wiederholungen. Sag es einmal, an der besten Stelle.
- Füllwörter als Übergänge („es ist erwähnenswert, dass“, „wie oben erwähnt“, „um zu“).
- Kommentare, die kein Verhalten ändern („unglamourös, aber wichtig“).
- Vage Quantifizierung („ein überraschender Anteil“). Nenne den wahren Grund, warum es funktioniert, oder streiche die Behauptung.
- Absicherungen, die eine Festlegung vermeiden. Formuliere echte Unsicherheit klar mit den Entscheidungskriterien.
- Blockzitate zur Hervorhebung. Behalte sie für Warnungen, die das Verhalten des Lesers ändern.
Streichen, was Text als generiert kennzeichnet
Ein Modell wählt, was für die breiteste Leserschaft passt; ein Autor wählt für einen Leser und ein Thema. Suche zuerst nach der Struktur, weil sich die Wortgewohnheiten mit jedem Modell ändern. Ein Satz bleibt nur, wenn er diesem Leser etwas gibt, das er noch nicht hat.
- Inszenieren statt Aussagen. „Nicht X, sondern Y“, wenn niemand X gesagt hat, ein einzeiliger Abschluss, der den Punkt wiederholt, ein Anlauf vor dem Punkt, ein Spruch, der tief klingt und nichts behauptet. Formuliere die Tatsache.
- Rhythmus nach Schema. Überall Triaden und Gedankenstriche, wiederholte Satzanfänge, gestapelte Einschränkungen. Verwende drei Elemente, wenn es drei sind.
- Aufblähen. Gewöhnliche Fakten werden als entscheidend oder robust bezeichnet, Verkaufssprache, ungenannte Autoritäten, „-end“-Anhängsel, die eine Bedeutung andeuten. Sage, was es tut, oder streiche es.
- Formatierung nach Schema. Jedes Element fett, jeder Gedanke eine Überschrift, wo Hervorhebung oder Struktur nichts bedeuten.
- Entwurfsreste. Chat-Umrandungen, Haftungsausschlüsse zu Wissensgrenzen, eine Überschrift, die als erster Satz wiederholt wird, Text über das Dokument statt über sein Thema.
- Der falsche Leser. Erkläre bereits Bekanntes erneut, sodass die Entscheidung zuletzt kommt.
Behalte, was der Autor meinte, und füge nichts hinzu, um das Gestrichene zu ersetzen. Ein echter Kontrast, eine echte Liste von drei oder eine zitierte Quelle bleibt; ein Erkennungsmerkmal zählt nur, wenn es nichts hinzufügt.
Geschützt: Das Warum ist nie Füllmaterial
Behalte einen Satz, der erklärt, warum (diese Reihenfolge, dieses Werkzeug, diese Prüfung zuerst, dieser Schritt kann nicht übersprungen werden), auch wenn er keine Anweisung gibt: Der Grund ermöglicht es dem Leser, mit dem Fall umzugehen, den das Dokument nicht vorhergesehen hat, und zu erkennen, wann das Verfahren nicht mehr gilt. Gib den Grund überall dort an, wo er nicht offensichtlich ist, vor allem bei Sicherheits- und Compliance-Regeln, wo die Absicht es jemandem erlaubt, die Regel anzuwenden, wo keine sie abdeckt. Wenn ein Satz eine Ausschmückung und einen Grund enthält, schreibe ihn um, um den Grund zu behalten. Der Test ist: „Wäre der Leser ohne diesen Satz schlechter in dieser Sache?“
Unverdiente Struktur streichen
Füge Ebenen, Tabellen, Matrizen, verschachtelte Überschriften oder Verzweigungen nur dort hinzu, wo die Arbeit sie braucht, nicht weil sie streng wirken. Frage: Verzweigt die Arbeit hier tatsächlich (wenn jeder Leser denselben Weg nimmt, ist es eine Liste)? Ist dieser Schritt nötig oder wirkt er nur gründlich? Wenn das Verfahren vier Schritte hat, schreibe vier: Ein vierstufiges Verfahren, das beim ersten Lesen befolgt wird, schlägt ein korrektes neunstufiges, das überflogen wird. Fallstricke, Sequenzfallen und das Warum bleiben.
Anleitungen, die ein Modell lädt
Regelblätter, Skills, Rollenbeschreibungen und Prompts werden mit Token bezahlt, jedes Mal wenn sie geladen werden, und der Leser ist ein Modell, das die Regel braucht, nicht die Geschichte dazu. Bepreise sie nach dem Zeitpunkt des Ladens (D28):
- Jede Sitzung (Regelblätter, Skill- und Rollenbeschreibungen): nur die Regel. Eine Beschreibung sagt, was das Skill abdeckt und wann es geladen werden soll, in unter 300 Zeichen;
tools/check.pyerzwingt die Budgets. - Bei Verwendung (ein Skill- oder Rollenkörper): die Regel plus ein Grund. Nur ein konkretes Versagen, wenn die Regel ohne es als optional erscheint, ohne Daten, Zählungen oder Projektnamen.
- Auf Abruf (
NOTES.md,EVIDENCE*.md): die Vorfälle, Zahlen, Daten und Quellen. Der Körper verweist dorthin.
Schreibe im Imperativ. Wiederhole keine Regel, die eine andere geladene Datei enthält; verweise mit Namen darauf. Eine festgelegte Anforderung in docs/REQUIREMENTS.tsv zieht mit ihrer Neufassung um, nie stillschweigend.
Aufbau eines Verfahrens
Zweck → Wann verwenden → Vorbereitung → Schritte → Überprüfen → Wenn es nicht funktioniert → Eskalieren
- Nie „Überprüfen“ weglassen: Es ist der am häufigsten übersprungene und wertvollste Teil.
- Ein Schritt pro Aktion. Benenne UI-Elemente exakt. Gib den vollständigen Pfad an.
- Kennzeichne irreversible Schritte vor dem Schritt, nicht danach.
- Schreibe für einen kompetenten Fremden: Kennt die Domäne, hat diese Umgebung nie gesehen.
- Titel nennen, wonach jemand suchen würde. Keine Daten, Versionen oder „v2“.
Ton
- Klare Sprache, kurze Sätze.
- Weiche keine Konsequenzen mit Zähnen auf (Verfall, Kündigung, Datenverlust, persönliche Haftung): Sage es deutlich.
- Verlinke Herstellerdokumentation, anstatt sie zu kopieren, und dokumentiere nur, was für die eigene Arbeitsweise spezifisch ist: Ein Nachdruck ist bei Ankunft veraltet.