Skip to content

AI协作工作流:WorkBuddy建知识库+Codex写开发记录+Obsidian沉淀

2026年4月30日

让三个AI工具自动协作,每个工具干自己最擅长的事:WorkBuddy创建知识库、Codex记录开发过程、Obsidian沉淀知识。这套工作流让我同时拥有代码执行能力、知识沉淀、和可查询的开发记录。

起因:为什么需要三个工具协作

开发过程中有两个常见的痛苦:

代码写完了,知识丢了。 你花了两个小时解决一个bug,理解了一整套技术逻辑,但只要不写文档,这两个小时的经验就永远消失在下一次需要的时候。

手动维护文档的成本太高。 大多数人不是不想记录,是记录的成本太高——写代码已经够累了,还要再整理一遍写成文档,中间的摩擦足以让大多数人放弃。

三工具分工

工具角色核心能力
WorkBuddy知识管理员创建和维护Obsidian页面、更新索引、管理文件结构
Codex开发日志写入器开发过程中实时记录,把代码变更和决策写入知识库
Obsidian知识沉淀层本地存储、双向链接、随时可查询

工具一:WorkBuddy创建知识库

WorkBuddy(腾讯的AI桌面智能体)扮演"知识管理员"的角色。

具体做法

第一次配置好vault路径之后,后续:

我:帮我创建一个Obsidian页面,记录今天研究的RAG技术方案
WorkBuddy:自动创建来源/RAG-2026-04-30.md
包含技术方案、决策点、待验证假设等结构化字段

WorkBuddy会:

  • 遵循已有的文件命名规范
  • 在对应目录下创建(来源/、概念/、实体/)
  • 更新index.md或相关索引页

灵魂文件(SOUL.md)

WorkBuddy的灵魂文件里可以注入哲学层,决定它处理知识库的判断逻辑。

比如"存续为体,形式为用"——知识库的价值在于被使用,不是为了完美而存在。所以它不会给你生成一个过于复杂的schema,而是服务于可读性。

工具二:Codex记录开发过程

Codex(OpenAI的编程Agent)扮演"开发日志写入器"。

MCP插件机制

Codex有一个MCP插件机制,可以让它连接到各种外部工具。配置好Obsidian MCP Server后,Codex就可以在执行开发任务的过程中,把关键节点直接写入Obsidian。

具体做法

在Codex的agents.md里配置好Obsidian vault路径和写入规则:

1. 完成代码重构
2. 自动创建开发记录页:
   - 改了什么(diff摘要)
   - 决策原因(为什么选这个方案)
   - 验证结果(跑通了哪些测试)
   - 待观察项(有没有性能风险)

对比:手动写 vs Codex自动写

方式问题
手动写开发完了再回忆 → 漏掉细节 → 没人看
Codex自动写开发过程中实时记录 → 有具体上下文 → 下次可直接查

工具三:Obsidian知识沉淀

Obsidian在这套工作流里是"接收端"和"查询端"。

核心价值

  • 纯Markdown:本地文件,任何工具都可以读写
  • 双向链接:让知识形成网络,不只是堆砌文档
  • Dataview插件:可以用SQL查询你的笔记
  • 画布(Canvas):可以可视化知识之间的关系

完整工作流示例

场景:研究一个新的技术方案,从调研到代码实现到知识沉淀

第一步:WorkBuddy创建调研页

我:帮我研究一下RAG和知识图谱结合的方案,整理到Obsidian
WorkBuddy:
→ 创建来源/RAG+知识图谱-2026-04-30.md
→ 填充技术背景、主流方案对比、关键问题列表
→ 更新index.md的相关索引

第二步:Codex执行开发,同时记录过程

我:用Codex实现RAG+知识图谱的混合检索
Codex:
→ 写代码、跑通demo
→ 同时自动写入:开发/RAG混合检索-2026-04-30.md

记录内容:

  • 选了哪个方案、为什么
  • 遇到了什么问题、怎么解决的
  • 测试结果如何

第三步:Obsidian沉淀,随时可查

我(之后某天):RAG混合检索怎么做的来着?
Obsidian:
→ 搜索「RAG」→ 找到调研页+开发记录页
→ 通过双向链接导航到相关概念页
→ 完整还原当时的决策过程

适用场景

  • ✅ 技术研究、需要长期积累的技术决策
  • ✅ 个人开发、想要建立个人知识资产
  • ✅ 需要反复查阅技术笔记的开发者

核心收获

知识管理不是"记笔记",是设计信息的流动路径。

工具职责
WorkBuddy把外部信息流入知识库
Codex把内部生产过程记录进知识库
Obsidian让知识产生连接而不是堆积

三个工具各自做自己最擅长的事,协作起来比任何一个单独用都要强大。

不要孤军奋战啦!

加入微信群一起学习交流 AI

与大神一起使用 OpenClaw、Hermes、Claude Code、Seedance 2.0、GPT-Image-2 等

微信公众号

扫码关注微信公众号
私信 "加群",将自动获取微信群二维码

探索 AI 世界,掌握智能未来