claude-werkzeuge/.claude/skills/anleitung-straffen/SKILL.md

name, description

name

description

anleitung-straffen

Baut eine bestehende technische Anleitung in den Stil aus AI/Regelwerk/schreibstil.md um — zerlegt sie in Anleitung (Schritte, Code, Prüfen) und Hintergrund (Warum, Architektur, Fallstricke), setzt eine Kommentarzeile je Codeabschnitt und belegt per Aussagenliste, dass kein Inhalt verloren ging. Nutze diesen Skill, wenn von Anleitung straffen, kürzen, umbauen, zu lang, Textwüste oder in den neuen Stil bringen die Rede ist. Nicht für neue Dokumente, die entstehen gleich im neuen Stil.

Anleitung straffen

Die Regeln stehen in AI/Regelwerk/schreibstil.md (Abschnitte „Anleitung und Hintergrund", „Code in Dokumenten", „Die Grenze"). Lies sie vor dem ersten Schritt. Dieser Skill beschreibt nur den Ablauf.

Ablauf

1. Quelle ganz lesen. Die Anleitung vollständig, nicht in Auszügen.
2. Aussagenliste anlegen im Scratchpad (aussagen.md): jede Aussage der Quelle als eigene Zeile.
   • Befehle, Pfade, Versionen, Werte, Bedingungen, Warnungen, Fehlermeldungen einzeln.
   • Nummeriert: A-01, A-02, …
3. Sortieren: je Aussage ein Ziel.
   • anleitung — Schritt, Codeblock, Voraussetzung, Prüfung, ⚠-Zeile am Schritt
   • hintergrund — Warum, Architektur, Alternativen, Details zu Fallstricken, Quellen
   • streichen — nur Floskeln ohne Aussage („Der Prozess ist nun abgeschlossen"); jede gestrichene Zeile mit Grund
4. Dateien schreiben.
   • Dateinamen und Titel nach schreibstil.md, Abschnitt „Bestehende Anleitungen umbauen".
   • Frontmatter der neuen Hintergrundseite: gleiches Schema; von den bookstack_*-Feldern nur bookstack_shelf, bookstack_book, bookstack_chapter übernehmen. Nie bookstack_page_id, bookstack_hash oder bookstack_synced kopieren — der Upload-Skill würde sonst die Seite der Anleitung mit dem Hintergrund überschreiben.
   • Links zwischen beiden Seiten nach schreibstil.md, Abschnitt „Anleitung und Hintergrund".
   • Codeblöcke: Zeilenkommentare entfernen, je Abschnitt eine Kommentarzeile; was die Zeilenkommentare erklärten, wandert in den Hintergrund.
5. Verlustprobe. Tabelle Aussage | Ziel | Fundstelle (Datei, Überschrift) für jede A-NN.
   • Fehlt eine Aussage in beiden Dateien und steht nicht unter streichen: nachtragen, bevor du weitermachst.
   • Bedingungen und Versionsangaben wörtlich gegen die Quelle vergleichen, nicht aus dem Gedächtnis.
6. Nacharbeiten.
   • Frontmatter: updated auf heute, Tag review in tags.
   • Im Text beider Seiten ein #review setzen und ein vorhandenes #review-done entfernen. Der Upload-Skill liest nur den Text (bookstack-upload/scripts/bookstack/auswahl.py); ein Frontmatter-Tag allein hält eine freigegebene Seite nicht vom Upload ab.
   • Nach Pascals Freigabe: erst die Hintergrundseite hochladen, dann die Anleitung ein zweites Mal. Beim ersten Lauf hat der Hintergrund noch keine Seiten-ID, der Link in der Anleitung wird sonst zu reinem Text.
   • Seed-MOC des Themenordners: Eintrag für die Hintergrundseite ergänzen.
   • Linkcheck: PYTHONIOENCODING=utf-8 python .vault-tools/linkcheck/linkcheck.py --vault . ohne neue tote Links.
7. Bericht an Pascal: beide Pfade, Zahl der Aussagen je Ziel, jede gestrichene Aussage mit Grund, alles, was du nicht zuordnen konntest.

Grenzen

• Ändert keine Aussage, nur ihre Form und ihren Ort. Findest du einen inhaltlichen Fehler, melde ihn und lass ihn stehen.
• Regelteile von ISMS- und Compliance-Dokumenten fasst der Skill nicht an (siehe „Wo der Stil nicht gilt").
• Mehrere Anleitungen: je Anleitung ein eigener Durchgang mit eigener Aussagenliste.