Pascal MichelandClaude Opus 5
2c9a4475fc
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]>
2.5 KiB
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, 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
-
Immer zuerst der Probelauf. Ohne
--anwendenschreibt nichts:python -m bookstack.hochladenArbeitsverzeichnis:
D:\Claude\Code Projekte\active - Bookstack Upload\skill\scripts -
Bericht lesen. Er listet je Notiz ANLEGEN, AKTUALISIEREN, ÜBERSPRUNGEN oder FEHLER.
-
Fehlende Zuordnung klären. Meldet der Bericht für eine Notiz, dass Buch oder Kapitel nicht existiert oder
bookstack_bookfehlt:- 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-anlegenergänzen.
- Vorhandene Struktur zeigen:
-
Bericht vorlegen und Freigabe einholen. Erst nach ausdrücklichem „ja" schreiben:
python -m bookstack.hochladen --anwenden -
Ergebnis melden. Was wurde angelegt, was aktualisiert, was übersprungen. Hinweise zu nicht übertragenen Bildern und nicht auflösbaren Wikilinks (offene Verweise) weitergeben.
Grenzen
--anwendenniemals ungefragt ausführen. Der Upload ist nach außen sichtbar.- Notizen mit offenem
#reviewwerden 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.