Pascal MichelandClaude Opus 5.5
fa1c26b407
.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]>
78 lines
4.3 KiB
Markdown
78 lines
4.3 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, 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.
|