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]>
57 lines
2.5 KiB
Markdown
57 lines
2.5 KiB
Markdown
---
|
|
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.
|