|
你有没有过这种体验：用 Claude Code 写了一天代码，debug 了 3 个小时，好不容易搞定了，第二天打开项目——完全想不起来昨天到底改了啥、为什么这么改。 翻 git log？只有干巴巴的 commit message。开 Notion 记？手动来回切换太麻烦，写了两天就放弃了。至于那些"项目文档"——说实话，大部分人的文档从写完那天起就再也没更新过。 今天推荐的这个工具，直接让 Claude Code 帮你自动写项目笔记。  [size=0.12] 它是什么
一句话总结：一个预配置好的 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 云模型） 然后在任意项目目录里运行： /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 自动生成的。 |
关注公众号
发表于 