Pascal MichelandClaude Opus 5
e8472409e9
- .claude/agents/executer.md - .claude/agents/recherche.md - .claude/skills/anleitung-straffen/SKILL.md - .vault-tools/linkcheck/docs/plans/2026-09-29-waisen/00-uebersicht.md - .vault-tools/linkcheck/docs/plans/2026-09-29-waisen/task-01-zaehler.md - .vault-tools/linkcheck/docs/plans/2026-09-29-waisen/task-02-sitzungsstart.md - .vault-tools/linkcheck/docs/plans/2026-09-29-waisen/task-03-regeltexte.md - .vault-tools/linkcheck/docs/plans/2026-09-29-waisen/task-04-bestandsskript.md - .vault-tools/linkcheck/docs/plans/2026-09-29-waisen/task-05-bestandslauf.md - .vault-tools/workflow-pruefung/docs/plans/2026-09-29-quorum/00-uebersicht.md - .vault-tools/workflow-pruefung/docs/plans/2026-09-29-quorum/task-01-quorum-werkzeug.md - .vault-tools/workflow-pruefung/docs/plans/2026-09-29-quorum/task-02-quorum-workflow.md - … und 13 weitere Erzeugt vom PostToolUse-Hook .vault-tools/auto-push/auto_push.py. Co-Authored-By: Claude Opus 5 <[email protected]>
41 lines
3.6 KiB
Markdown
41 lines
3.6 KiB
Markdown
---
|
|
name: anleitung-straffen
|
|
description: '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.
|