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

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

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

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

　　
它是什么

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

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

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

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

　　 自動生成開發(fā)日志（Dev Log）

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

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

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

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

　　項目采用了 Johnny Decimal 的編號系統(tǒng)來組織文件夾：

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


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

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

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

　　 階段

　　 做什么

　　 怎么做

　　檢測

　　 識別當(dāng)前項目

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

　　分析

　　 讀代碼

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

　　菜單

　　 讓你選

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

　　執(zhí)行

　　 寫入 Vault

　　 自動生成或更新 Markdown 文件

　　報告

　　 匯總變更

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

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

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

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

　　 入口文件（紅色）

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

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

　　 UI/視圖/輸出（綠色）

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

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

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

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

　　項目還貼心地準(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

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

　　安裝部署

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

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

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

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

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

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


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

　　/obsidian


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

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

　　CLAUDE.md — 給 Claude 的說明書

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

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

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

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

　　 Canvas 顏色代碼的含義

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

　　進(jìn)階玩法

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

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

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

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

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

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

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

　　One More Thing

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