Cobsidian 是做什麼的?
核心原則
將知識庫維護為一個連結的知識系統。不要僅僅生成一個獨立的 Markdown 檔案。
回覆語言
模式選擇、澄清問題和完成報告時,使用與用戶相同的語言。
- 中文請求 -> 中文模式名稱。
- 英文請求 -> 英文模式名稱。
- 混合語言請求 -> 使用主導的用戶語言,並在有用時以反引號包含規範的模式 ID。
知識庫解析
按以下順序解析目標知識庫:
- 用戶請求中明確的知識庫路徑。
cobsidian.config.yml中的vault.path。- 透過
COBSIDIAN_CONFIG的 MCP 主機配置。 - 透過
COBSIDIAN_VAULT的 MCP 主機配置。
不要猜測私有知識庫的路徑。如果沒有有效的知識庫路徑,請要求一個簡潔的輸入:知識庫路徑或配置文件路徑。如果路徑存在但無效,請報告無效的路徑,並在寫入之前要求更正後的知識庫/配置文件路徑。
模式選擇
如果用戶明確選擇了模式,則使用它並且不要顯示完整的模式選單。如果沒有選擇模式,則推斷最小有用的模式,並在寫入之前說明它。如果模式不明確且涉及檔案編輯,則簡要介紹這些模式,並在寫入之前提出一個簡潔的問題。
| 模式 | 英文觸發詞 | 中文觸發詞 | 用途 |
|---|---|---|---|
learning | learning mode, study note, explain | 学习模式, 知识点整理, 学习笔记 | 概念、課程、影片、論文、技術說明。 |
project | project mode, repo analysis, architecture | 项目模式, 项目整理, 源码项目 | 專案架構、實作筆記、儲存庫分析、運維文件。 |
review | review mode, retrospective, failure review | 复盘模式, 事故复盘, 实验复盘, 失败复盘 | 事件、實驗結果、失敗、經驗教訓。 |
comparison | comparison mode, compare, evaluate options | 对比模式, 选型, 方案比较 | 工具選擇、架構選項、模型/資料庫/框架比較。 |
index | index mode, map, learning path | 索引模式, 总览, 知识地图, 学习路线 | 主題地圖、中樞筆記、學習路徑、導航頁面。 |
capture | capture mode, daily capture, quick note | 捕获模式, 日常记录, 先记下来 | 輕量級日常捕獲,以便日後深入整理。 |
dissection | dissection mode, teardown, source analysis | 拆解模式, 源码拆解, 框架拆解, skill拆解 | 逆向工程工具、儲存庫、框架、代理系統、提示詞、技能、工作流程。 |
互動式模式介紹
不要假設用戶已經閱讀過 README 或模式文件。在以下情況於對話中解釋模式:
- 用戶是 Cobsidian 新手,或詢問 Cobsidian 能做什麼
- 用戶廣泛地要求將資料整理/寫入 Obsidian,但沒有明確的筆記類型
- 相同的資料可以合理地變成不同的筆記類型
- 目標編輯會因模式而異,例如精緻的學習筆記 vs 粗略的日常捕獲
當用戶已經選擇了模式、模式很明顯,或用戶要求直接執行時,跳過選擇器。在這種情況下,說明推斷出的模式並繼續:
Mode: dissection / 拆解, because this is a framework or workflow teardown.
當需要選擇器時,使用用戶的語言。
英文模式選擇器:
Cobsidian can organize this in several modes:
- learning: concepts, courses, videos, papers
- project: repos, architecture, implementation, operations
- review: failures, incidents, experiments, lessons
- comparison: tool/model/database/architecture choices
- index: topic maps, learning paths, hub notes
- capture: quick rough notes for later cleanup
- dissection: internals of tools, frameworks, repos, skills, prompts
Choose one mode, or tell me to infer it.
中文模式選擇:
Cobsidian 可以按這些模式整理:
- 学习模式:概念、課程、視頻、論文、技術解釋
- 项目模式:倉庫、架構、實現、運維記錄
- 复盘模式:失敗、事故、實驗結果、經驗教訓
- 对比模式:工具、模型、數據庫、架構選型
- 索引模式:主題地圖、學習路線、導航頁
- 捕获模式:先快速保存粗糙材料,後續再整理
- 拆解模式:拆解工具、框架、倉庫、skill、提示詞系統
選一個模式,或者告訴我由我推斷。
工作流程
- 識別用戶的知識庫路徑和目標主題。
- 在寫入之前搜尋現有筆記。
- 在寫入之前選擇、推斷或介紹模式。
- 決定以下之一:
- 建立新筆記
- 追加到現有筆記
- 拆分為多個筆記
- 僅報告重複項並在編輯前詢問
- 撰寫簡潔的 Markdown,並使用穩定的標題。
- 添加相關的
[[wiki 連結]]到現有筆記。 - 在有用時添加「相關筆記」部分。
- 執行驗證或至少報告已檢查的內容。
寫入規則
- 保留用戶現有的筆記命名風格。
- 優先使用持久的概念,而不是聊天記錄摘要。
- 除非用戶明確要求本地操作記錄,否則不要將私有路徑、令牌、帳戶名稱和原始日誌放入通用筆記。
- 不要捏造來源、文件名或已完成的檢查。
- 如果相同主題已存在,則追加或合併,而不是創建近乎重複的內容。
輔助腳本
scripts/scan_vault.py:總結筆記、標題、標籤和 wiki 連結。scripts/find_duplicates.py:檢測重複或相似的筆記標題。scripts/suggest_backlinks.py:為草稿或目標筆記建議相關筆記。scripts/validate_notes.py:報告缺失的 wiki 連結和基本的健康問題。scripts/dry_run.py:在不更改檔案的情況下規劃寫入;報告創建/追加決定、重複風險、反向連結建議、驗證意圖和空寫入。
當用戶有包含 vault.path、閾值、反向連結限制和驗證偏好的專案配置時,使用 --config cobsidian.config.yml。
在選擇筆記形式時,請閱讀 references/note-types.md。
在添加連結時,請閱讀 references/backlink-policy.md。
在格式化筆記時,請閱讀 references/markdown-style.md。
完成報告
結束時報告:
- 已創建或修改的檔案
- 創建/追加決定
- 已執行的重複檢查
- 已添加或跳過的反向連結建議
- 驗證結果或未執行驗證的原因