Was macht obsidian-loop-wiki?
Loop Engineering für Ihren Obsidian-Vault: Ein agentenunabhängiger Skill (Claude Code / Codex / Gemini), der Artikel in einen typisierten, wikilink-basierten Wissensgraphen kompiliert und das Ergebnis mit einem dependenciesfreien Checker verifiziert, der Goodhart-artigem Gaming widersteht. Enthält einen lauffähigen Demo-Vault.
Einführung
Dieser Skill automatisiert den Prozess, Artikel zu sammeln, sie in kleinere, miteinander verbundene Notizen (Atome) zu zerlegen und diese in einem Obsidian-Vault zu strukturieren. Er nutzt das Konzept des "Loop Engineering", um iterativ Verbesserungen vorzunehmen und die Qualität des Wissensgraphen zu sichern.
Funktionsweise
- Artikelextraktion: Liest Artikel aus einer definierten Quelle (z. B. einer Textdatei oder einem Ordner).
- Atomisierung: Zerlegt jeden Artikel in einzelne Konzepte (Atome), die als separate Notizen gespeichert werden.
- Typisierung und Wikilinks: Weist jedem Atom einen Typ zu (z. B. "Konzept", "Person", "Ereignis") und erstellt Wikilinks zwischen verwandten Atomen.
- Validierung: Führt einen integrierten Checker aus, der die Konsistenz des Graphen überprüft (z. B. auf fehlende Links, isolierte Knoten oder zirkuläre Abhängigkeiten).
- Loop: Der gesamte Prozess kann wiederholt werden, um den Graphen basierend auf Feedback zu verbessern.
Verwendung
Voraussetzungen
- Ein Obsidian-Vault (oder ein beliebiger Textordner).
- Claude Code, Codex oder ein Gemini-kompatibles Tool.
- Keine externen Abhängigkeiten für den Checker.
Schnellstart
- Klonen Sie das Repository:
git clone https://github.com/uninhibited-scholar/obsidian-loop-wiki.git
cd obsidian-loop-wiki
- Öffnen Sie den Demo-Vault in Obsidian:
obsidian open ./demo-vault
- Führen Sie den Skill mit Ihrem agenten aus (z. B. Claude Code):
claude-code --context . --prompt "Compile articles from /source-articles into the vault."
Manuelle Nutzung
- Platzieren Sie Ihre Artikel im Ordner
source-articles/. - Führen Sie den Hauptworkflow aus (abhängig von Ihrem agenten).
- Überprüfen Sie die Ausgabe im Vault.
- Bei Bedarf führen Sie die Validierung aus:
python validate_vault.py --vault ./vault
Validierung
Der Checker (validate_vault.py) ist dependenciesfrei und prüft:
- Vollständigkeit: Sind alle Typen und Links vorhanden?
- Konsistenz: Sind alle Wikilinks auflösbar?
- Robustheit: Wird erkannt, wenn der Graph durch übermäßige Optimierung (Goodhart) verzerrt wird?
Integration
Dieser Skill ist agentenunabhängig und funktioniert mit:
- Claude Code: Über den
SKILL.md-Parser. - Codex: Durch direkte Integration oder Skripte.
- Gemini: Über die entsprechende API.
Demo-Vault
Im Ordner demo-vault/ finden Sie einen funktionsfähigen Obsidian-Vault mit Beispiel-Artikeln und generierten Atomen. Dieser dient als Referenz und Testumgebung.
Weiterführende Informationen
Lizenz
MIT – siehe LICENSE-Datei.