你有沒有過這種體驗：用 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 就會自動幫你：

• 讀取當前項目的代碼結(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    — 項目管理（重點?。?br/>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. /obsidian Skill — 一鍵同步的核心命令

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

階段

做什么

怎么做

檢測

識別當前項目

匹配工作目錄到已有的 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)，不用擔心 Claude 把你之前的筆記搞丟。

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

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

• 入口文件（紅色）

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

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

• UI/視圖/輸出（綠色）

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

• 標簽/分組名（紫色）

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

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

項目還貼心地準備了 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)，帶水手月亮圖標

Base Theme CRT Terminal Y2K Web 1.0 RuneScape Coquette

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

安裝部署

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

• Obsidian（免費個人使用）

• 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 絕對路徑

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

/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 少犯很多錯。

進階玩法

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

• 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 用的什么認證方案？"

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

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

One More Thing

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