Claude Code + Obsidian：讓 AI 自動化知識管理

　　你有沒有過這種體驗：用 Claude Code 寫了一天代碼，debug 了 3 個小時，好不容易搞定了，第二天打開項目——完全想不起來昨天到底改了啥、為什么這么改。

　　翻 git log？只有干巴巴的 commit message。開 Notion 記？手動來回切換太麻煩，寫了兩天就放棄了。至于那些"項目文檔"——說實話，大部分人的文檔從寫完那天起就再也沒更新過。

　　今天推薦的這個工具，直接讓 Claude Code 幫你自動寫項目筆記。

　　項目地址：https://github.com/nemocake/claude-obsidian-assistant

　　
它是什么

　　一句話總結：一個預配置好的 Obsidian 模板庫，讓 Claude Code 能直接讀寫你的筆記。

　　和手動記筆記比，它的核心區別是——你只需要在終端敲一個命令/obsidian，Claude 就會自動幫你：

　　 讀取當前項目的代碼結構、技術棧、git 記錄

　　 在 Obsidian 里創建/更新對應的項目文件

　　 自動生成開發日志（Dev Log）

　　 還能畫出代碼架構圖（直接生成 Obsidian Canvas 文件）

　　不需要任何 Obsidian 插件，不需要額外的 CLI 工具。純粹就是 Claude Code 直接讀寫 Markdown 和 JSON 文件。

　　和 Notion、語雀這類在線文檔比，Obsidian 的優勢在于：文件就是本地 Markdown，Claude Code 可以像讀寫代碼一樣操作它們，沒有 API 限制，沒有格式轉換的問題。這波操作，還得是本地優先的 Obsidian。

　　核心亮點 1. Johnny Decimal 文件系統 — 一眼看懂整個知識庫

　　項目采用了 Johnny Decimal 的編號系統來組織文件夾：

　　00-09 System — 系統配置、模板、看板
10-19 Projects — 項目管理（重點！）
20-29 Writing — 寫作、日記
30-39 Knowledge — 知識庫、閱讀清單
40-49 Tracking — 待辦、習慣追蹤
50-59 Creative — 創意、繪畫、實驗


　　每個項目文件自動編號（11.01,11.02...），不用你操心命名和歸類的問題。這個設計其實很聰明——它讓 Claude 能用確定性的規則來定位和創建文件，而不是靠模糊匹配瞎猜。

　　2. /obsidianSkill — 一鍵同步的核心命令

　　這是整個項目的靈魂。一條/obsidian命令，Claude 會走完 5 個階段：

　　 階段

　　 做什么

　　 怎么做

　　檢測

　　 識別當前項目

　　 匹配工作目錄到已有的 Vault 文件

　　分析

　　 讀代碼

　　 掃描 package.json、目錄結構、git log

　　菜單

　　 讓你選

　　 更新信息 / 寫日志 / 刷新關鍵文件 / 生成架構圖

　　執行

　　 寫入 Vault

　　 自動生成或更新 Markdown 文件

　　報告

　　 匯總變更

　　 告訴你創建/更新了哪些文件

　　如果你的項目已經在 Obsidian 里有記錄，Claude 會增量更新——只添加新內容，不會覆蓋你之前寫的東西。開發日志是 append-only 的，最新的排在最前面。這個設計比較穩，不用擔心 Claude 把你之前的筆記搞丟。

　　3. 自動生成架構 Canvas — 代碼可視化

　　這個功能有點意思。Claude 會分析你的代碼庫，按層把組件分類：

　　 入口文件（紅色）

　　 狀態管理/配置（橙色）

　　 數據層/持久化（黃色）

　　 UI/視圖/輸出（綠色）

　　 API 層/外部服務（青色）

　　 標簽/分組名（紫色）

　　生成的.canvas文件是 Obsidian 原生格式，你可以直接在 Obsidian 里拖拽、編輯、添加注釋。如果你之前苦于畫架構圖，這功能直接幫你省了。

　　4. 五套主題 — 顏值即正義

　　項目還貼心地準備了 5 套 CSS 主題：

　　 主題

　　 風格

　　base-theme.css

　　 干凈的深色主題

　　crt-terminal.css

　　 綠色 CRT 終端復古風

　　y2k-web1.css

　　 90年代 GeoCities 風格

　　runescape.css

　　 經典游戲 RuneScape 風格

　　coquette.css

　　 粉色少女風，帶水手月亮圖標

Base Theme CRT Terminal Y2K Web 1.0 RuneScape Coquette

　　每個主題都是獨立的 CSS 文件，在 Obsidian 設置 → 外觀 → CSS 代碼片段里一鍵切換。不喜歡？直接讓 Claude 幫你改配色，或者從零做一個新的。

　　安裝部署

　　環境要求很簡單：

　　 Obsidian（免費個人使用）

　　 Claude Code（需要訂閱，也可以用第三方 API，甚至是 Ollama 云模型）

　　#1. 克隆倉庫
git clone https://github.com/nemocake/claude-obsidian-assistant.git

#2. 用 Obsidian 打開這個文件夾作為 Vault
#3. 把 skill 文件復制到 Claude Code 的命令目錄
cp claude-code/obsidian-sync.md ~/.claude/commands/obsidian.md

#4. 編輯復制后的文件，設置你的 Vault 路徑
#找到 VAULT_PATH，改成你的 Obsidian Vault 絕對路徑


　　然后在任意項目目錄里運行：

　　/obsidian


　　搞定。Claude 會自動檢測項目、提供操作菜單，你選一個就行了。

　　可選步驟：安裝 Dataview 插件（社區插件搜索 "Dataview"），首頁看板需要它來統計項目數據。

　　CLAUDE.md — 給 Claude 的說明書

　　項目根目錄有個CLAUDE.md文件，這個設計很關鍵。它告訴 Claude：

　　 Vault 的文件結構是什么樣的

　　 每種文件格式的規范（Markdown、Canvas、YAML frontmatter）

　　 編輯規則（不能刪已有內容、日志只能追加、Canvas 必須是合法 JSON）

　　 Canvas 顏色代碼的含義

　　本質上就是 Claude Code 的 Memory 文件，但專門針對 Obsidian 使用場景做了優化。如果你用過 Claude Code 的 Skills 系統，就知道這東西有多重要——一個好的 CLAUDE.md 能讓 Claude 少犯很多錯。

　　進階玩法

　　作者在 README 里列了幾個擴展方向，我覺得每個都挺實用：

　　 Session Memory ：讓 Claude 每次開工前先讀 Vault 里的項目筆記，前一次的 debug 記錄、架構決策都還在，不用每次重新解釋上下文

　　 自動文檔更新 ：用 Claude Code Hooks 在每次 commit 后自動觸發 Vault 更新，開發日志自己寫自己

　　 GitHub 集成 ：把 Issue、PR 狀態、CI 信息拉到 Vault 里，一個地方看完所有項目狀態

　　 跨項目查詢 ：建一個 /vault-query skill，隨時問"哪個項目用了 Redis？"、"上一個 App 用的什么認證方案？"

　　 決策日志 ：記錄架構決策的來龍去脈——考慮了什么方案、最終選了哪個、為什么

　　這些擴展如果你有空折騰，每一個都能顯著提升開發體驗。特別是 Session Memory，配合 Claude Code 的 Skill 系統使用，基本等于給 AI 裝上了"長期記憶"。

　　One More Thing

　　。事實上，我公眾號里很多文章的配圖、知識卡片，都是通過自定義 Skills 自動生成的。