Communitygithub.com

Cobsidian

Agent-unabhängige Workflow-Fähigkeit zur Pflege von Obsidian-Wissensdatenbanken

Was ist Cobsidian?

Cobsidian ist ein agentenunabhängiger Workflow-Skill, der KI-Agenten wie Claude Code, Cursor oder Codex befähigt, eine Obsidian-Vault als vernetztes Wissenssystem zu pflegen, anstatt nur isolierte Markdown-Dateien zu erstellen. Es unterstützt mehrere Modi (Lernen, Projekt, Rekapitulation, Vergleich, Index, Erfassung, Zerlegung), die der Agent je nach Anforderung automatisch auswählt oder vom Benutzer erfragt. Der Skill durchsucht bestehende Notizen, erkennt Duplikate, schlägt Backlinks vor und validiert die Struktur – alles über konfigurierbare Hilfsskripte. Plattformunabhängig und mehrsprachig (Deutsch, Englisch, Chinesisch) konzipiert, ist Cobsidian besonders nützlich für Entwickler, die ihre KI-Workflows mit einer strukturierten, verknüpften Wissensbasis in Obsidian kombinieren möchten.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add Totoro-qaq/Cobsidian

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht Cobsidian?

Kernprinzip

Verwalte die Vault als vernetztes Wissenssystem. Erstelle nicht einfach nur eine eigenständige Markdown-Datei.

Antwortsprache

Passe die Sprache an die des Benutzers an für Modusauswahl, Rückfragen und Abschlussberichte.

  • Anfrage auf Deutsch -> deutsche Modusnamen.
  • Anfrage auf Englisch -> englische Modusnamen.
  • Anfrage gemischtsprachig -> verwende die dominante Benutzersprache und füge kanonische Modus-IDs in Backticks hinzu, wenn hilfreich.

Vault-Ermittlung

Ermittle die Ziel-Vault in dieser Reihenfolge:

  1. Expliziter Vault-Pfad in der Benutzeranfrage.
  2. cobsidian.config.yml mit vault.path.
  3. MCP-Host-Konfiguration über COBSIDIAN_CONFIG.
  4. MCP-Host-Konfiguration über COBSIDIAN_VAULT.

Rate keinen privaten Vault-Pfad. Wenn kein gültiger Vault-Pfad verfügbar ist, frage nach einer kurzen Eingabe: dem Vault-Pfad oder dem Konfigurationspfad. Wenn ein Pfad vorhanden, aber ungültig ist, melde den ungültigen Pfad und bitte vor dem Schreiben um einen korrigierten Vault-/Konfigurationspfad.

Modusauswahl

Wenn der Benutzer explizit einen Modus auswählt, verwende ihn und zeige nicht das vollständige Modusmenü. Wenn kein Modus ausgewählt ist, folgere den kleinsten sinnvollen Modus und teile ihn vor dem Schreiben mit. Wenn der Modus uneindeutig ist und Dateibearbeitungen betroffen sind, stelle die Modi kurz vor und frage vor dem Schreiben eine kurze Frage.

ModusEnglische AuslöserDeutsche AuslöserVerwendung
learninglearning mode, study note, explainLernmodus, Lernnotiz, erklärenKonzepte, Kurse, Videos, Paper, technische Erklärungen.
projectproject mode, repo analysis, architectureProjektmodus, Projektnotiz, Repo-AnalyseProjektarchitektur, Implementierungsnotizen, Repo-Analyse, Betriebsdokumentation.
reviewreview mode, retrospective, failure reviewRekapitulationsmodus, Retrospektive, FehleranalyseVorfälle, experimentelle Ergebnisse, Fehler, gewonnene Erkenntnisse.
comparisoncomparison mode, compare, evaluate optionsVergleichsmodus, vergleichen, Optionen bewertenWerkzeugwahl, Architekturoptionen, Modell-/Datenbank-/Framework-Vergleiche.
indexindex mode, map, learning pathIndexmodus, Übersicht, Wissenslandkarte, LernpfadThemenkarten, Hub-Notizen, Lernpfade, Navigationsseiten.
capturecapture mode, daily capture, quick noteErfassungsmodus, tägliche Erfassung, KurznotizLeichte tägliche Erfassung vor tieferer Organisation.
dissectiondissection mode, teardown, source analysisZerlegungsmodus, Zerlegung, Quellcode-AnalyseReverse Engineering von Tools, Repos, Frameworks, Agentensystemen, Prompts, Skills, Workflows.

Interaktive Moduseinführung

Gehe nicht davon aus, dass der Benutzer die README oder die Modusdokumentation gelesen hat. Erkläre Modi im Gespräch, wenn:

  • der Benutzer neu bei Cobsidian ist oder fragt, was Cobsidian kann
  • der Benutzer allgemein bittet, Material in Obsidian zu organisieren/zu schreiben, ohne einen klaren Notiztyp zu nennen
  • dasselbe Material vernünftigerweise zu verschiedenen Notiztypen werden könnte
  • die Zielbearbeitung je nach Modus unterschiedlich wäre, z. B. polierte Lernnotiz vs. grobe tägliche Erfassung

Überspringe die Auswahl, wenn der Benutzer bereits einen Modus gewählt hat, der Modus offensichtlich ist oder der Benutzer um direkte Ausführung gebeten hat. Gib in diesem Fall den abgeleiteten Modus an und fahre fort:

Modus: dissection / Zerlegung, da dies eine Framework- oder Workflow-Zerlegung ist.

Wenn die Auswahl benötigt wird, verwende die Sprache des Benutzers.

Deutsche Modusauswahl:

Cobsidian kann dies in mehreren Modi organisieren:
- Lernmodus: Konzepte, Kurse, Videos, Paper, technische Erklärungen
- Projektmodus: Repos, Architektur, Implementierung, Betrieb
- Rekapitulationsmodus: Fehler, Vorfälle, Experimente, Erkenntnisse
- Vergleichsmodus: Tool-/Modell-/Datenbank-/Architekturauswahl
- Indexmodus: Themenkarten, Lernpfade, Hub-Notizen
- Erfassungsmodus: schnelle, grobe Notizen für spätere Bereinigung
- Zerlegungsmodus: Interna von Tools, Frameworks, Repos, Skills, Prompts

Wähle einen Modus oder sag mir, dass ich ihn ableiten soll.

Arbeitsablauf

  1. Identifiziere den Vault-Pfad des Benutzers und das Zielthema.
  2. Durchsuche vorhandene Notizen vor dem Schreiben.
  3. Wähle aus, leite ab oder stelle den Modus vor dem Schreiben ein.
  4. Entscheide dich für eine der folgenden Optionen:
    • neue Notiz erstellen
    • an vorhandene Notiz anhängen
    • in mehrere Notizen aufteilen
    • nur Duplikate melden und vor dem Bearbeiten fragen
  5. Schreibe prägnantes Markdown mit stabilen Überschriften.
  6. Füge relevante [[Wiki-Links]] zu vorhandenen Notizen hinzu.
  7. Füge bei Bedarf einen Abschnitt „Verwandte Notizen“ hinzu.
  8. Führe eine Validierung durch oder melde zumindest, was geprüft wurde.

Schreibregeln

  • Behalte den vorhandenen Notizbenennungsstil des Benutzers bei.
  • Bevorzuge dauerhafte Konzepte gegenüber Chat-Transkript-Zusammenfassungen.
  • Halte private Pfade, Tokens, Kontonamen und Rohprotokolle aus generischen Notizen heraus, es sei denn, der Benutzer möchte ausdrücklich lokale Betriebsaufzeichnungen.
  • Erfinde keine Quellen, Dateinamen oder abgeschlossenen Prüfungen.
  • Wenn dasselbe Thema bereits existiert, hänge an oder führe zusammen, anstatt ein nahezu identisches Duplikat zu erstellen.

Hilfsskripte

  • scripts/scan_vault.py: fasse Notizen, Titel, Tags und Wiki-Links zusammen.
  • scripts/find_duplicates.py: erkenne doppelte oder ähnliche Notiztitel.
  • scripts/suggest_backlinks.py: schlage verwandte Notizen für einen Entwurf oder eine Zielnotiz vor.
  • scripts/validate_notes.py: melde fehlende Wiki-Links und grundlegende Hygieneprobleme.
  • scripts/dry_run.py: plane einen Schreibvorgang, ohne Dateien zu ändern; melde Entscheidung zum Erstellen/Anhängen, Duplikatrisiken, Backlink-Vorschläge, Validierungsabsicht und leere Schreibvorgänge.

Verwende --config cobsidian.config.yml, wenn der Benutzer eine Projektkonfiguration mit vault.path, Schwellwerten, Backlink-Limits und Validierungseinstellungen hat.

Lies references/note-types.md, wenn du die Notizform wählst. Lies references/backlink-policy.md, wenn du Links hinzufügst. Lies references/markdown-style.md, wenn du Notizen formatierst.

Abschlussbericht

Beende mit:

  • erstellte oder geänderte Dateien
  • Entscheidung zum Erstellen/Anhängen
  • durchgeführte Duplikatprüfungen
  • hinzugefügte oder übersprungene Backlink-Vorschläge
  • Validierungsergebnis oder Grund, warum die Validierung nicht ausgeführt wurde

Verwandte Skills