Communitygithub.com

Totoro-qaq/Cobsidian

與代理無關的工作流程技能,用於維護 Obsidian 知識庫

Cobsidian 是什麼?

Cobsidian 是一個與代理無關的技能,旨在幫助 AI 代理在 Obsidian 知識庫中有效地創建和維護結構化筆記。它的核心原則是將知識庫視為一個連結的知識系統,而非僅生成獨立的 Markdown 檔案。此技能支援多種筆記模式(如學習、專案、復盤、比較、索引、捕獲、拆解),並能根據用戶的意圖自動推斷或提示選擇最合適的模式。Cobsidian 會先解析知識庫路徑、搜尋現有筆記以避免重複,並在寫入前決定是新建、追加還是合併筆記。它還提供多個輔助腳本(如掃描、查重、建議反向連結)來增強工作流程,並要求代理在完成時提供包含檔案變更、重複檢查結果和驗證狀態的報告。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add Totoro-qaq/Cobsidian

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Cobsidian 是做什麼的?

核心原則

將知識庫維護為一個連結的知識系統。不要僅僅生成一個獨立的 Markdown 檔案。

回覆語言

模式選擇、澄清問題和完成報告時,使用與用戶相同的語言。

  • 中文請求 -> 中文模式名稱。
  • 英文請求 -> 英文模式名稱。
  • 混合語言請求 -> 使用主導的用戶語言,並在有用時以反引號包含規範的模式 ID。

知識庫解析

按以下順序解析目標知識庫:

  1. 用戶請求中明確的知識庫路徑。
  2. cobsidian.config.yml 中的 vault.path。
  3. 透過 COBSIDIAN_CONFIG 的 MCP 主機配置。
  4. 透過 COBSIDIAN_VAULT 的 MCP 主機配置。

不要猜測私有知識庫的路徑。如果沒有有效的知識庫路徑,請要求一個簡潔的輸入:知識庫路徑或配置文件路徑。如果路徑存在但無效,請報告無效的路徑,並在寫入之前要求更正後的知識庫/配置文件路徑。

模式選擇

如果用戶明確選擇了模式,則使用它並且不要顯示完整的模式選單。如果沒有選擇模式,則推斷最小有用的模式,並在寫入之前說明它。如果模式不明確且涉及檔案編輯,則簡要介紹這些模式,並在寫入之前提出一個簡潔的問題。

模式英文觸發詞中文觸發詞用途
learninglearning mode, study note, explain学习模式, 知识点整理, 学习笔记概念、課程、影片、論文、技術說明。
projectproject mode, repo analysis, architecture项目模式, 项目整理, 源码项目專案架構、實作筆記、儲存庫分析、運維文件。
reviewreview mode, retrospective, failure review复盘模式, 事故复盘, 实验复盘, 失败复盘事件、實驗結果、失敗、經驗教訓。
comparisoncomparison mode, compare, evaluate options对比模式, 选型, 方案比较工具選擇、架構選項、模型/資料庫/框架比較。
indexindex mode, map, learning path索引模式, 总览, 知识地图, 学习路线主題地圖、中樞筆記、學習路徑、導航頁面。
capturecapture mode, daily capture, quick note捕获模式, 日常记录, 先记下来輕量級日常捕獲,以便日後深入整理。
dissectiondissection 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、提示詞系統

選一個模式,或者告訴我由我推斷。

工作流程

  1. 識別用戶的知識庫路徑和目標主題。
  2. 在寫入之前搜尋現有筆記。
  3. 在寫入之前選擇、推斷或介紹模式。
  4. 決定以下之一:
    • 建立新筆記
    • 追加到現有筆記
    • 拆分為多個筆記
    • 僅報告重複項並在編輯前詢問
  5. 撰寫簡潔的 Markdown,並使用穩定的標題。
  6. 添加相關的 [[wiki 連結]] 到現有筆記。
  7. 在有用時添加「相關筆記」部分。
  8. 執行驗證或至少報告已檢查的內容。

寫入規則

  • 保留用戶現有的筆記命名風格。
  • 優先使用持久的概念,而不是聊天記錄摘要。
  • 除非用戶明確要求本地操作記錄,否則不要將私有路徑、令牌、帳戶名稱和原始日誌放入通用筆記。
  • 不要捏造來源、文件名或已完成的檢查。
  • 如果相同主題已存在,則追加或合併,而不是創建近乎重複的內容。

輔助腳本

  • 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。

完成報告

結束時報告:

  • 已創建或修改的檔案
  • 創建/追加決定
  • 已執行的重複檢查
  • 已添加或跳過的反向連結建議
  • 驗證結果或未執行驗證的原因

相關技能