Erste Fassung: Claude-Werkzeuge aus dem Vault

.vault-tools (ohne trading-plattform-pruefung und watermarks-remover), .claude/agents, .claude/skills, .claude/workflows, .claude/settings.json. Co-Authored-By: Claude Opus 5.5 <[email protected]>
2026-10-14 11:27:59 +02:00
commit fa1c26b407
@@ -0,0 +1,77 @@
+---
+name: bookstack-upload
+description: '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.