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:
- Expliziter Vault-Pfad in der Benutzeranfrage.
cobsidian.config.ymlmitvault.path.- MCP-Host-Konfiguration über
COBSIDIAN_CONFIG. - 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.
| Modus | Englische Auslöser | Deutsche Auslöser | Verwendung |
|---|---|---|---|
learning | learning mode, study note, explain | Lernmodus, Lernnotiz, erklären | Konzepte, Kurse, Videos, Paper, technische Erklärungen. |
project | project mode, repo analysis, architecture | Projektmodus, Projektnotiz, Repo-Analyse | Projektarchitektur, Implementierungsnotizen, Repo-Analyse, Betriebsdokumentation. |
review | review mode, retrospective, failure review | Rekapitulationsmodus, Retrospektive, Fehleranalyse | Vorfälle, experimentelle Ergebnisse, Fehler, gewonnene Erkenntnisse. |
comparison | comparison mode, compare, evaluate options | Vergleichsmodus, vergleichen, Optionen bewerten | Werkzeugwahl, Architekturoptionen, Modell-/Datenbank-/Framework-Vergleiche. |
index | index mode, map, learning path | Indexmodus, Übersicht, Wissenslandkarte, Lernpfad | Themenkarten, Hub-Notizen, Lernpfade, Navigationsseiten. |
capture | capture mode, daily capture, quick note | Erfassungsmodus, tägliche Erfassung, Kurznotiz | Leichte tägliche Erfassung vor tieferer Organisation. |
dissection | dissection mode, teardown, source analysis | Zerlegungsmodus, Zerlegung, Quellcode-Analyse | Reverse 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
- Identifiziere den Vault-Pfad des Benutzers und das Zielthema.
- Durchsuche vorhandene Notizen vor dem Schreiben.
- Wähle aus, leite ab oder stelle den Modus vor dem Schreiben ein.
- 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
- Schreibe prägnantes Markdown mit stabilen Überschriften.
- Füge relevante
[[Wiki-Links]]zu vorhandenen Notizen hinzu. - Füge bei Bedarf einen Abschnitt „Verwandte Notizen“ hinzu.
- 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