Wiki-Fertigkeit
Diese Fertigkeit macht den Agenten zu einem disziplinierten Verwalter der persönlichen Wissensdatenbank des Benutzers unter <VAULT_ROOT> (dem Repository-Root).
Schritt 0 – Lies zuerst immer AGENTS.md
Bevor du irgendetwas tust, lies AGENTS.md im Vault-Root. Es definiert das Verzeichnislayout, Seitenkonventionen, das Frontmatter-Schema, das Log-Format und detaillierte Arbeitsabläufe. Dieses SKILL.md ist nur ein Verteiler; AGENTS.md ist die Quelle der Wahrheit.
Verteiler: Wonach fragt der Benutzer?
Wähle genau eine dieser Absichten aus der Nachricht des Benutzers aus:
| Benutzerabsicht | Arbeitsablauf |
|---|---|
| Stellt eine Frage, möchte Analyse/Synthese | Abfrage (siehe unten) |
| Neue Datei abgelegt oder sagt „dies aufnehmen“ | Aufnehmen (siehe AGENTS.md §4.1) |
| Sagt „lint“ / „Gesundheitscheck“ / „Probleme finden“ | Linten (siehe unten) |
| Möchte einen Vergleich / eine Folienpräsentation / ein Diagramm / einen Bericht | Artefakt generieren (siehe unten) |
| Erkundet nur oder unsicher | Führe wiki stats aus und frage dann, was der Benutzer möchte |
Falls unklar, stelle eine kurze klärende Frage, bevor du fortfährst.
Abfrage-Arbeitsablauf
-
Führe
wiki search <Schlüsselwort>im Repository-Root aus, um Kandidatenseiten zu finden. Verwende bei Bedarf mehrere Schlüsselwort-Varianten. -
Lies
wiki/index.md, um den Katalog zu sehen. -
Lies die Kandidatenseiten aus Schritt 1.
-
Falls immer noch Kontext fehlt, greife auf die relevanten Dateien in
raw/oderclippings/zurück. -
Synthetisiere eine Antwort mit
[[Wikilink]]-Zitaten auf Wiki-Seiten und[Artikel](../raw/xxx.md)-Zitaten auf Rohquellen. -
Wenn die Antwort dauerhaften Wert hat (ein Vergleich, eine abgeleitete Einsicht, eine nicht-triviale Synthese), schreibe sie als Markdown-Datei nach
output/<YYYY-MM-DD>-<kurzer-slug>.mdmit Frontmatter:--- type: artifact kind: answer | comparison | analysis | report | slides created: <Datum> question: "<die Frage des Benutzers, wörtlich>" sources_used: [wiki/concepts/X.md, wiki/sources/Y.md, ...] ---Frage dann den Benutzer: „Soll ich diese Ausgabe als
wiki/questions/<slug>.mdarchivieren?“ (Wenn ja, kopieren undindex.md&log.mdaktualisieren.) -
Wenn die Antwort trivial ist (eine Faktenabfrage), antworte einfach im Chat – keine Datei nötig.
Linten-Arbeitsablauf
- Führe
wiki lintaus – dies schreibt automatischlint/<heute>.md. - Lies diese Datei und fasse sie für den Benutzer zusammen (welche Probleme real sind, welche False Positives sind, z. B. wörtliche
[[Beispiele]]in Dokumentationen). - Schlage einen priorisierten Korrekturplan vor. Korrigiere nicht automatisch – lass den Benutzer wählen.
Artefakt-generieren-Arbeitsablauf
Gleich wie Abfrage, aber die Lieferform ist explizit (Tabelle / Marp-Folien / Python-Diagramm / Canvas). Speichere immer in output/. Für Folienpräsentationen verwende das Marp-Markdown-Format. Für Diagramme schreibe ein Python-Skript nach output/scripts/ und führe es aus, um das Bild daneben zu erzeugen.
Ausgabeverzeichnis-Konvention
output/
├── 2026-06-26-rag-vs-llm-wiki.md # Antwort-/Vergleichs-Artefakt
├── 2026-06-26-karpathy-zusammenfassung.slides.md # Marp-Foliensatz
├── scripts/ # Hilfsskripte zur Diagrammerstellung
└── assets/ # gerenderte Bilder, Exporte
Das output/-Verzeichnis ist LLM-eigen, nur anhängend (lösche keine früheren Artefakte ohne Nachfrage). Jede Datei muss das oben gezeigte Frontmatter haben, damit der Benutzer Artefakte später ins Wiki übernehmen kann.
Verfügbare CLI-Befehle (ausgeführt von <VAULT_ROOT>)
Nur vier Befehle, bewusst minimal gehalten:
wiki stats # Übersicht: Seitenanzahl nach Typ/Status
wiki log -n 10 # Letzte N Einträge aus wiki/log.md
wiki search <regex> # Volltextsuche (--scope wiki|raw|clippings|all)
wiki lint # Schreibe lint/<heute>.md mit Verwaisten/kaputten/Stubs
Alles andere (Seiten erstellen, Frontmatter bearbeiten, index.md aktualisieren, Einträge an log.md anhängen) wird durch direktes Lesen und Schreiben von Markdown-Dateien erledigt. Bitte nicht nach einem CLI für Dateibearbeitungen fragen – das ist deine Aufgabe.
Kritische Regeln (aus AGENTS.md)
- Ändere niemals Dateien in
raw/oderclippings/. - Jede Aufnahme muss
wiki/index.mdaktualisieren und einen Eintrag inwiki/log.mdmit Format## [YYYY-MM-DD] ingest | <Titel>voranstellen. - Verwende
[[Doppelte-Klammern]]für Querverweise zwischen Wiki-Seiten. - Seiten benötigen YAML-Frontmatter (
type,tags,created,updated,sources,status). - Bei Unsicherheit frage den Benutzer. Führe keine stillen großen Umstrukturierungen durch.
Berichtsstil
Gib dem Benutzer nach Abschluss eines Arbeitsablaufs eine kurze Zusammenfassung:
- Was du getan hast (1–3 Aufzählungspunkte)
- Welche Artefakte erstellt oder geändert wurden (relative Pfade)
- Alle ungelösten Fragen oder neuen Lücken, die dir aufgefallen sind
Halte es knapp. Der Benutzer durchstöbert parallel Obsidian und kann Dateiänderungen sehen.