你有沒(méi)有過(guò)這種體驗(yàn)：用 Claude Code 寫(xiě)了一天代碼，debug 了 3 個(gè)小時(shí)，好不容易搞定了，第二天打開(kāi)項(xiàng)目——完全想不起來(lái)昨天到底改了啥、為什么這么改。

　　翻 git log？只有干巴巴的 commit message。開(kāi) Notion 記？手動(dòng)來(lái)回切換太麻煩，寫(xiě)了兩天就放棄了。至于那些"項(xiàng)目文檔"——說(shuō)實(shí)話，大部分人的文檔從寫(xiě)完那天起就再也沒(méi)更新過(guò)。

　　今天推薦的這個(gè)工具，直接讓 Claude Code 幫你自動(dòng)寫(xiě)項(xiàng)目筆記。

　　項(xiàng)目地址：https://github.com/nemocake/claude-obsidian-assistant

　　
它是什么

　　一句話總結(jié)：一個(gè)預(yù)配置好的 Obsidian 模板庫(kù)，讓 Claude Code 能直接讀寫(xiě)你的筆記。

　　和手動(dòng)記筆記比，它的核心區(qū)別是——你只需要在終端敲一個(gè)命令/obsidian，Claude 就會(huì)自動(dòng)幫你：

　　 讀取當(dāng)前項(xiàng)目的代碼結(jié)構(gòu)、技術(shù)棧、git 記錄

　　 在 Obsidian 里創(chuàng)建/更新對(duì)應(yīng)的項(xiàng)目文件

　　 自動(dòng)生成開(kāi)發(fā)日志（Dev Log）

　　 還能畫(huà)出代碼架構(gòu)圖（直接生成 Obsidian Canvas 文件）

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

　　和 Notion、語(yǔ)雀這類在線文檔比，Obsidian 的優(yōu)勢(shì)在于：文件就是本地 Markdown，Claude Code 可以像讀寫(xiě)代碼一樣操作它們，沒(méi)有 API 限制，沒(méi)有格式轉(zhuǎn)換的問(wèn)題。這波操作，還得是本地優(yōu)先的 Obsidian。

　　核心亮點(diǎn) 1. Johnny Decimal 文件系統(tǒng) — 一眼看懂整個(gè)知識(shí)庫(kù)

　　項(xiàng)目采用了 Johnny Decimal 的編號(hào)系統(tǒng)來(lái)組織文件夾：

　　00-09 System — 系統(tǒng)配置、模板、看板
10-19 Projects — 項(xiàng)目管理（重點(diǎn)?。?br/>20-29 Writing — 寫(xiě)作、日記
30-39 Knowledge — 知識(shí)庫(kù)、閱讀清單
40-49 Tracking — 待辦、習(xí)慣追蹤
50-59 Creative — 創(chuàng)意、繪畫(huà)、實(shí)驗(yàn)


　　每個(gè)項(xiàng)目文件自動(dòng)編號(hào)（11.01,11.02...），不用你操心命名和歸類的問(wèn)題。這個(gè)設(shè)計(jì)其實(shí)很聰明——它讓 Claude 能用確定性的規(guī)則來(lái)定位和創(chuàng)建文件，而不是靠模糊匹配瞎猜。

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

　　這是整個(gè)項(xiàng)目的靈魂。一條/obsidian命令，Claude 會(huì)走完 5 個(gè)階段：

　　 階段

　　 做什么

　　 怎么做

　　檢測(cè)

　　 識(shí)別當(dāng)前項(xiàng)目

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

　　分析

　　 讀代碼

　　 掃描 package.json、目錄結(jié)構(gòu)、git log

　　菜單

　　 讓你選

　　 更新信息 / 寫(xiě)日志 / 刷新關(guān)鍵文件 / 生成架構(gòu)圖

　　執(zhí)行

　　 寫(xiě)入 Vault

　　 自動(dòng)生成或更新 Markdown 文件

　　報(bào)告

　　 匯總變更

　　 告訴你創(chuàng)建/更新了哪些文件

　　如果你的項(xiàng)目已經(jīng)在 Obsidian 里有記錄，Claude 會(huì)增量更新——只添加新內(nèi)容，不會(huì)覆蓋你之前寫(xiě)的東西。開(kāi)發(fā)日志是 append-only 的，最新的排在最前面。這個(gè)設(shè)計(jì)比較穩(wěn)，不用擔(dān)心 Claude 把你之前的筆記搞丟。

　　3. 自動(dòng)生成架構(gòu) Canvas — 代碼可視化

　　這個(gè)功能有點(diǎn)意思。Claude 會(huì)分析你的代碼庫(kù)，按層把組件分類：

　　 入口文件（紅色）

　　 狀態(tài)管理/配置（橙色）

　　 數(shù)據(jù)層/持久化（黃色）

　　 UI/視圖/輸出（綠色）

　　 API 層/外部服務(wù)（青色）

　　 標(biāo)簽/分組名（紫色）

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

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

　　項(xiàng)目還貼心地準(zhǔn)備了 5 套 CSS 主題：

　　 主題

　　 風(fēng)格

　　base-theme.css

　　 干凈的深色主題

　　crt-terminal.css

　　 綠色 CRT 終端復(fù)古風(fēng)

　　y2k-web1.css

　　 90年代 GeoCities 風(fēng)格

　　runescape.css

　　 經(jīng)典游戲 RuneScape 風(fēng)格

　　coquette.css

　　 粉色少女風(fēng)，帶水手月亮圖標(biāo)

Base Theme CRT Terminal Y2K Web 1.0 RuneScape Coquette

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

　　安裝部署

　　環(huán)境要求很簡(jiǎn)單：

　　 Obsidian（免費(fèi)個(gè)人使用）

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

　　#1. 克隆倉(cāng)庫(kù)
git clone https://github.com/nemocake/claude-obsidian-assistant.git

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

#4. 編輯復(fù)制后的文件，設(shè)置你的 Vault 路徑
#找到 VAULT_PATH，改成你的 Obsidian Vault 絕對(duì)路徑


　　然后在任意項(xiàng)目目錄里運(yùn)行：

　　/obsidian


　　搞定。Claude 會(huì)自動(dòng)檢測(cè)項(xiàng)目、提供操作菜單，你選一個(gè)就行了。

　　可選步驟：安裝 Dataview 插件（社區(qū)插件搜索 "Dataview"），首頁(yè)看板需要它來(lái)統(tǒng)計(jì)項(xiàng)目數(shù)據(jù)。

　　CLAUDE.md — 給 Claude 的說(shuō)明書(shū)

　　項(xiàng)目根目錄有個(gè)CLAUDE.md文件，這個(gè)設(shè)計(jì)很關(guān)鍵。它告訴 Claude：

　　 Vault 的文件結(jié)構(gòu)是什么樣的

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

　　 編輯規(guī)則（不能刪已有內(nèi)容、日志只能追加、Canvas 必須是合法 JSON）

　　 Canvas 顏色代碼的含義

　　本質(zhì)上就是 Claude Code 的 Memory 文件，但專門(mén)針對(duì) Obsidian 使用場(chǎng)景做了優(yōu)化。如果你用過(guò) Claude Code 的 Skills 系統(tǒng)，就知道這東西有多重要——一個(gè)好的 CLAUDE.md 能讓 Claude 少犯很多錯(cuò)。

　　進(jìn)階玩法

　　作者在 README 里列了幾個(gè)擴(kuò)展方向，我覺(jué)得每個(gè)都挺實(shí)用：

　　 Session Memory ：讓 Claude 每次開(kāi)工前先讀 Vault 里的項(xiàng)目筆記，前一次的 debug 記錄、架構(gòu)決策都還在，不用每次重新解釋上下文

　　 自動(dòng)文檔更新 ：用 Claude Code Hooks 在每次 commit 后自動(dòng)觸發(fā) Vault 更新，開(kāi)發(fā)日志自己寫(xiě)自己

　　 GitHub 集成 ：把 Issue、PR 狀態(tài)、CI 信息拉到 Vault 里，一個(gè)地方看完所有項(xiàng)目狀態(tài)

　　 跨項(xiàng)目查詢 ：建一個(gè) /vault-query skill，隨時(shí)問(wèn)"哪個(gè)項(xiàng)目用了 Redis？"、"上一個(gè) App 用的什么認(rèn)證方案？"

　　 決策日志 ：記錄架構(gòu)決策的來(lái)龍去脈——考慮了什么方案、最終選了哪個(gè)、為什么

　　這些擴(kuò)展如果你有空折騰，每一個(gè)都能顯著提升開(kāi)發(fā)體驗(yàn)。特別是 Session Memory，配合 Claude Code 的 Skill 系統(tǒng)使用，基本等于給 AI 裝上了"長(zhǎng)期記憶"。

　　One More Thing

　　。事實(shí)上，我公眾號(hào)里很多文章的配圖、知識(shí)卡片，都是通過(guò)自定義 Skills 自動(dòng)生成的。