📚
文档的两套系统
AI 看的 ≠ 人看的
终端产的文档是给 AI 看的(CodeRef 风格、指向代码、项目内、易逝);但作为开发者要理解 AI 干了啥,需要的是功能视角的总览蓝图。两套并存,靠桥连通——task-* 删掉后,中间文档正好靠这套接住。
给 AI 看
系统① 终端 / Claude Code
- CodeRef 风格(指向代码行)
- 项目内 · 用完即弃 · 易逝
- 产物:spec · plan · CodeRef 文档
→
ob-bridge
会话产物+transcript 卸货到 _inbox/
←
Claudian 插件
Obsidian 内直接写代码 · 文档 YAML→真实 repo 本地地址
给人看
系统② Obsidian
- 功能视角 · 总览蓝图
- 跨项目知识库 · 长期理解
- 产物:wiki/ 蓝图 · _inbox/ 暂存
喂养蓝图
ob-project-logStop hook 自动·
ob-topic/save·
ob-collect→ob-compilestatus 翻转
⟹ob-index 串成网
元数据双向链
项目 CLAUDE.md <!-- ob-index -->
⇄
wiki YAML project: · OBA-xxxx
ob-index 维护两端 + 反思引擎挖跨域关联
🖥️
环境轴
贯穿编码~验证
管"代码在哪改、在哪跑"——不属于某个阶段,是整个工程的环境能力。
remote-dev-sync远端(算力强)改 → 本地 git pull 跑