Regelwerk, Agenten, Skills und Werkzeuge veröffentlichen

Erster Stand des öffentlichen Ausschnitts aus dem Vault. Die .gitignore arbeitet als Positivliste: ausgeschlossen ist alles, eingeschlossen nur, was ausdrücklich wieder aufgenommen wird. Notizen, Projekte, Finanzen, das Sitzungsgedächtnis und settings.local.json bleiben damit außen vor. Der Kundenname in AI/Regelwerk/seo.md ist durch eine neutrale Bezeichnung ersetzt; die Regeln selbst sind unverändert. Co-Authored-By: Claude Opus 5 <[email protected]>
2026-09-17 22:38:15 +02:00
commit c064c729ed
@@ -0,0 +1,56 @@
+---
+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, 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 Notiz ANLEGEN, AKTUALISIEREN, ÜBERSPRUNGEN oder FEHLER.
+
+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.
+
+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.
+
+## 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 werden zu echten Seitenlinks. Verweise auf
+  noch nicht hochgeladene Notizen bleiben Klartext und werden im Bericht gemeldet.