跳至正文
Ende Sun
返回博客

开发者工作流

我如何整理技术知识:用 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 的区别。原子笔记记录的是别人说了什么;洞见记录的是我自己得出的结论,而且标题必须是一个真正的论断。如果我没法把它写成一个论断,那它还算不上洞见。

每天:十分钟

  • 用模板创建当天的日记,写下当天最关键的一项任务。
  • 白天出现的任何想法、链接或零散片段,都不假思索地直接放进收件箱。
  • 上课或工作时,原始笔记直接写进对应的项目或领域文件夹。我不会尝试当场写原子笔记。

每周:让系统真正运转的固定流程

每周一次,大约三十分钟,我打开一个维护面板,直到把上面的列表全部清空:

  1. 清空收件箱。 逐条判断:外部概念 → 100;自己的结论 → 200;操作流程 → 400;项目资料 → 500;参考资源 → 700。没有价值的直接删除。
  2. 两个链接原则。 每条笔记离开收件箱前至少要有两个链接:一个指向它所属的主题索引(MOC),另一个指向一条相关笔记。不链接任何内容的笔记毫无价值。
  3. 元数据(frontmatter)。 每条笔记都包含 type、area、created 和 status。状态从 seed(刚创建)到 growing(已审阅并建立链接),再到 evergreen(内容已稳定)。
  4. 过期的种子笔记。 超过三十天的种子笔记,要么继续完善,要么删除。

每个月我还会把已完成的项目归档,并为积累了五条以上笔记却还没有索引的主题创建索引。

Claude Code 的作用

笔记库根目录下有一个 CLAUDE.md 文件,描述了整体结构、每个文件夹的规则和元数据约定。在这个文件夹里打开的任何 Claude Code 会话都已经了解笔记库的运作方式,我不需要每次重新解释。

在此基础上,我为重复性工作定义了几个自定义命令:

命令 作用 使用时机
/procesar-inbox 给收件箱中的每条笔记分类,补充元数据和链接 每周整理
/conectar 找出孤立笔记,并链接到相关笔记 每周整理
/destilar <笔记> 把原始课堂笔记提炼成原子笔记和洞见 每次课后

每个命令其实就是一个写有明确指令的 Markdown 文件。比如,整理收件箱的命令要求代理在添加链接之前先搜索已有的相关笔记,只有当某个主题达到五条笔记时才创建索引,并且只能建议删除,而不是直接删除。提炼命令会读取我的课堂笔记——这些笔记使用一种很简单的语法(概念 :: 定义、=> 洞见、- [?] 疑问)——先检查是否已有重复内容,再新建或补充原子笔记,最后列出尚未解决的疑问,留给我自己处理。

与代理协作的规则

我认为最重要的部分并不是技术层面的:

  1. 我负责记录,AI 负责整理结构。 代理负责分类、链接和排版,但不替我写洞见。洞见由我自己写,因为写的过程本身才是学习真正发生的地方。
  2. 会话始终从笔记库根目录启动, 这样指令文件才会被加载。
  3. 检查差异。 笔记库用 Obsidian Git 插件做版本管理;如果代理做了较大的改动,我会先看 git diff 再确认。
  4. 删除操作必须确认。 这一点写进了每个命令里。

真正用起来

这样的系统只有在我确实回头去用时才有价值。几个习惯让这件事成为可能:

  • 做以前做过的任务之前,先打开流程索引,复用已有的标准流程,而不是从头再来。
  • 学习某个主题之前,先打开它的索引,看看自己已经掌握了什么、还有哪些空白。
  • 读完一本书或上完一门课后,写下三到五条洞见。如果一条都写不出来,说明其实什么都没学到。
  • 我也可以让代理基于我自己的笔记回答问题:“关于 X 我都记了什么?”,或者“把我 Android 笔记里 ContentProvider 的实现方式和新的练习对比一下”。

真正有用的插件

我装的插件远比实际用到的多。真正发挥作用的有:Templater(新笔记自动生成元数据)、Note Refactor(把选中的概念提取成一条带反向链接的新原子笔记)、Omnisearch(创建笔记前先确认是否已经存在)、Dataview(驱动维护面板和索引中的自动生成部分)、Spaced Repetition(在普通笔记中以 问题::答案 格式编写复习卡片)以及 Obsidian Git(自动备份)。现在我的规则很简单:一个月没用过的插件就卸载。

给刚起步的人的建议

不要从工具开始,而是先做两个决定:原始记录放在哪里,以及什么时候整理它们。其余的一切,包括 AI 代理,都是为了让每周的整理成本更低。代理擅长机械性的工作:分类、链接、排版。思考仍然由你自己完成——这是有意为之的。