claude-regelwerk/.claude/skills/bookstack-upload/SKILL.md

name, description

name

description

bookstack-upload

Lädt freigegebene Vault-Notizen (Tag #review-done) aus dem Ordner /Bookstack über die BookStack-API hoch — legt Seiten an oder aktualisiert sie, setzt Buch- und Kapitelbeschreibungen, zieht Verweise zwischen den Seiten nach, löst Regal/Buch/Kapitel aus dem Frontmatter auf und fragt nach, wenn die Zuordnung fehlt. Nutze diesen Skill, wenn von BookStack-Upload, Wiki-Upload, „hochladen nach Bookstack", „Doku veröffentlichen" oder vom Verarbeiten des /Bookstack-Ordners die Rede ist.

BookStack-Upload

Spielt freigegebene Dokumentation aus dem Vault in die BookStack-Instanz.

Voraussetzungen prüfen

Setze BOOKSTACK_URL, BOOKSTACK_TOKEN_ID und BOOKSTACK_TOKEN_SECRET voraus. Sind sie nicht gesetzt, meldet das Skript das verständlich — gib die Meldung weiter und brich ab. Frage niemals nach dem Token und schreibe ihn nirgends hin.

Ablauf

1. Immer zuerst der Probelauf. Ohne --anwenden schreibt nichts:

   python -m bookstack.hochladen
   

   Arbeitsverzeichnis: D:\Claude\Code Projekte\active - Bookstack Upload\skill\scripts

2. Bericht lesen. Er listet je Datei ANLEGEN, AKTUALISIEREN, ÜBERSPRUNGEN oder FEHLER, bei _Buchbeschreibung.md und _Kapitelbeschreibung.md zusätzlich BESCHREIBUNG („würde gesetzt“ oder „unverändert“). Die Zeile N× Verweis wird in der Verweisrunde aufgelöst zählt Links auf Seiten, die erst im selben Lauf entstehen, und ist kein Fehler. FEHLER-Zeilen mit „Beschreibung zu lang“ oder „Vorspann fehlt“ dem Anwender vor dem Upload vorlegen: Er kürzt oder ergänzt den Vorspann (Text zwischen H1 und erster H2). Ebenso FEHLER-Zeilen mit „Beschreibung nicht wohlgeformt: Hervorhebung falsch verschachtelt, nichts gesendet“: Er korrigiert die Hervorhebung im Vorspann, etwa ***a*** → **a**.

3. Fehlende Zuordnung klären. Meldet der Bericht für eine Notiz, dass Buch oder Kapitel nicht existiert oder bookstack_book fehlt:

   • Vorhandene Struktur zeigen: python -m bookstack.hochladen --baum
   • Dem Anwender die Regale und Bücher aus dieser Ausgabe zur Auswahl stellen und fragen, wo die Notiz landen soll. Nicht raten.
   • Die Antwort ins Frontmatter der Notiz schreiben (bookstack_shelf, bookstack_book, bookstack_chapter).
   • Soll etwas Neues angelegt werden, den Anwender das ausdrücklich bestätigen lassen und dann --struktur-anlegen ergänzen.
   • Meldet der Bericht bei einer Beschreibungsdatei „bookstack_chapter fehlt in der Kapitelbeschreibung“ oder „bookstack_chapter gehört nicht in eine Buchbeschreibung“, genauso nachfragen und das Frontmatter korrigieren.

4. Bericht vorlegen und Freigabe einholen. Erst nach ausdrücklichem „ja" schreiben:

   python -m bookstack.hochladen --anwenden
   

5. Ergebnis melden. Was wurde angelegt, was aktualisiert, was übersprungen. Hinweise zu nicht übertragenen Bildern und nicht auflösbaren Wikilinks (offene Verweise) weitergeben. ARCHIVIERT-Zeilen sind normaler Ablauf (Notizen wandern nach erfolgreichem Upload nach nicht hochladen - ARCHIV/), kein Fehler. Ebenso VERLINKT-Zeilen: Die Verweisrunde hat Links auf Seiten desselben Laufs nachgezogen. ARCHIV-FEHLER dagegen melden: Im Archiv liegt schon eine Datei mit demselben Pfad, die Notiz ist liegen geblieben. Nicht selbst löschen, den Anwender entscheiden lassen.

Grenzen

• --anwenden niemals ungefragt ausführen. Der Upload ist nach außen sichtbar.
• Notizen mit offenem #review werden bewusst übersprungen. Nicht umgehen.
• Bilder werden in die BookStack-Bildergalerie hochgeladen und eingebunden. Nicht gefundene oder abgelehnte Bilder erscheinen als Hinweis im Bericht.
• Wikilinks auf bereits hochgeladene Notizen und auf Seiten desselben Laufs werden zu echten Seitenlinks, Links auf Beschreibungsdateien zeigen auf deren Übersichtsseite. Verweise auf Notizen ohne Seite bleiben Klartext und werden im Bericht mit dem Ziel gemeldet, wie es in der Notiz steht.
• _Buchbeschreibung.md und _Kapitelbeschreibung.md brauchen #review-done wie jede Seite. Andere Dateien mit _ oder . am Anfang lädt der Lauf ohne --nur nicht hoch.
• Nach dem Archivieren zeigen Wikilinks aus dem übrigen Vault noch auf den alten Pfad. Der Skill zieht sie nicht nach; das beim Ergebnis dem Anwender sagen.