开发者工作流
我如何整理技术知识:用 Claude Code 运营的 Obsidian 第二大脑
阅读需 7 分钟
我如何整理技术知识:用 Claude Code 运营的 Obsidian 第二大脑
工作、硕士课程和个人项目加在一起,我每天都会记下很多东西:解决过的工单、课堂笔记、以后还会用到的命令、效果不错的提示词。很长一段时间里,这些笔记散落各处,实际上只写不读。真正改变这一点的不是换了一个新应用,而是一小套规则,再加上一个替我执行这些规则的 AI 代理。
下面是这套系统目前的运作方式。
唯一的原则:先记录,后整理
整个笔记库建立在一个原则上:把记录和整理分开。正在忙一件事的时候,我不去决定一条笔记该放在哪里——在记录时就做分类,恰恰是让习惯坚持不下去的原因。所有新内容都不加筛选地先放进收件箱文件夹,之后再用专门的时间统一整理。
文件夹结构
这个笔记库结合了两种常见方法:用 PARA(项目、领域、资源、归档)划分大的类别,用卡片盒(Zettelkasten)式的原子笔记承载知识。带编号的文件夹让顺序保持稳定:
| 文件夹 | 内容 | 放入规则 |
|---|---|---|
000 收件箱 |
所有新内容 | 原样记录,不做筛选 |
100 Atomic |
外部概念 | 一条笔记只写一个观点,标题简短 |
200 Insights |
自己的结论 | 标题是一个论断,以 = 开头 |
300 MOCs |
主题索引 | 某个主题积累到 5 条以上笔记时创建 |
400 流程 |
标准流程与提示词 | 可重复执行的步骤 |
500 项目 |
有截止日期的工作 | 客户项目和个人项目 |
600 领域 |
长期领域 | 学习、工作、个人 |
700 资源 |
参考资料 | 书籍、记忆卡组、图表 |
900 归档 |
已完成的内容 | 已结束的项目和课程 |
我最看重的是 100 和 200 的区别。原子笔记记录的是别人说了什么;洞见记录的是我自己得出的结论,而且标题必须是一个真正的论断。如果我没法把它写成一个论断,那它还算不上洞见。
每天:十分钟
- 用模板创建当天的日记,写下当天最关键的一项任务。
- 白天出现的任何想法、链接或零散片段,都不假思索地直接放进收件箱。
- 上课或工作时,原始笔记直接写进对应的项目或领域文件夹。我不会尝试当场写原子笔记。
每周:让系统真正运转的固定流程
每周一次,大约三十分钟,我打开一个维护面板,直到把上面的列表全部清空:
- 清空收件箱。 逐条判断:外部概念 →
100;自己的结论 →200;操作流程 →400;项目资料 →500;参考资源 →700。没有价值的直接删除。 - 两个链接原则。 每条笔记离开收件箱前至少要有两个链接:一个指向它所属的主题索引(MOC),另一个指向一条相关笔记。不链接任何内容的笔记毫无价值。
- 元数据(frontmatter)。 每条笔记都包含
type、area、created和status。状态从seed(刚创建)到growing(已审阅并建立链接),再到evergreen(内容已稳定)。 - 过期的种子笔记。 超过三十天的种子笔记,要么继续完善,要么删除。
每个月我还会把已完成的项目归档,并为积累了五条以上笔记却还没有索引的主题创建索引。
Claude Code 的作用
笔记库根目录下有一个 CLAUDE.md 文件,描述了整体结构、每个文件夹的规则和元数据约定。在这个文件夹里打开的任何 Claude Code 会话都已经了解笔记库的运作方式,我不需要每次重新解释。
在此基础上,我为重复性工作定义了几个自定义命令:
| 命令 | 作用 | 使用时机 |
|---|---|---|
/procesar-inbox |
给收件箱中的每条笔记分类,补充元数据和链接 | 每周整理 |
/conectar |
找出孤立笔记,并链接到相关笔记 | 每周整理 |
/destilar <笔记> |
把原始课堂笔记提炼成原子笔记和洞见 | 每次课后 |
每个命令其实就是一个写有明确指令的 Markdown 文件。比如,整理收件箱的命令要求代理在添加链接之前先搜索已有的相关笔记,只有当某个主题达到五条笔记时才创建索引,并且只能建议删除,而不是直接删除。提炼命令会读取我的课堂笔记——这些笔记使用一种很简单的语法(概念 :: 定义、=> 洞见、- [?] 疑问)——先检查是否已有重复内容,再新建或补充原子笔记,最后列出尚未解决的疑问,留给我自己处理。
与代理协作的规则
我认为最重要的部分并不是技术层面的:
- 我负责记录,AI 负责整理结构。 代理负责分类、链接和排版,但不替我写洞见。洞见由我自己写,因为写的过程本身才是学习真正发生的地方。
- 会话始终从笔记库根目录启动, 这样指令文件才会被加载。
- 检查差异。 笔记库用 Obsidian Git 插件做版本管理;如果代理做了较大的改动,我会先看
git diff再确认。 - 删除操作必须确认。 这一点写进了每个命令里。
真正用起来
这样的系统只有在我确实回头去用时才有价值。几个习惯让这件事成为可能:
- 做以前做过的任务之前,先打开流程索引,复用已有的标准流程,而不是从头再来。
- 学习某个主题之前,先打开它的索引,看看自己已经掌握了什么、还有哪些空白。
- 读完一本书或上完一门课后,写下三到五条洞见。如果一条都写不出来,说明其实什么都没学到。
- 我也可以让代理基于我自己的笔记回答问题:“关于 X 我都记了什么?”,或者“把我 Android 笔记里 ContentProvider 的实现方式和新的练习对比一下”。
真正有用的插件
我装的插件远比实际用到的多。真正发挥作用的有:Templater(新笔记自动生成元数据)、Note Refactor(把选中的概念提取成一条带反向链接的新原子笔记)、Omnisearch(创建笔记前先确认是否已经存在)、Dataview(驱动维护面板和索引中的自动生成部分)、Spaced Repetition(在普通笔记中以 问题::答案 格式编写复习卡片)以及 Obsidian Git(自动备份)。现在我的规则很简单:一个月没用过的插件就卸载。
给刚起步的人的建议
不要从工具开始,而是先做两个决定:原始记录放在哪里,以及什么时候整理它们。其余的一切,包括 AI 代理,都是为了让每周的整理成本更低。代理擅长机械性的工作:分类、链接、排版。思考仍然由你自己完成——这是有意为之的。