958 字
5 分钟
我的长期 AI 工作流交接:从 Obsidian 迁移到 Hermes/Codex/OMX
先说结论:这篇原本围绕 Obsidian 四件套的版本在现阶段已经不再是主流程。
现在的目标仍然不变:一句短指令就能恢复上下文。变化在于“上下文到底放哪里”以及“谁负责推进到哪里”。
当前栈分工:
- Hermes:总控、任务边界判断、知识库与会话信息协同。
- Codex:本地改码、构建、验证。
- OMX:执行层组织(持久化、团队化、Ralph/计划护栏)。
- personal-llm-wiki:项目管理主记忆库(长周期口径)。
- 项目仓库:执行真相层(
PROJECT_STATUS.md、HANDOFF.md等)。
这篇文章只更新“交接模型”,不是否定旧法,只是说明迁移到新默认结构。
核心原则(更新版)
1. 管理层 / 执行层 / 交接层必须分离
过去的问题不是“东西不够多”,而是不同生命周期信息混在一起。
- 管理层(长期):放在
personal-llm-wiki/wiki/projects/<project>.md。- 当前状态、风险、关注点、下一步
- 不直接等于实现细节,起到“项目恢复入口”作用
- 执行层(短周期真相):放在项目仓库。
PROJECT_STATUS.md、HANDOFF.md、NEXT-SESSION-START.md- 以及仓内 plan/notes/analysis 目录里的事实文件
- 交接层(会话):补充
omx的会话记录与仓库 handoff。- 用于下次接手时的最短恢复入口
2. 统一入口,但入口是个人库项目页,不是“单点文件夹”
每个项目仍保留一个入口:
personal-llm-wiki/wiki/projects/<slug>.md
这个入口承载的是:
- 项目主路径(如
/home/weathour/文档/CPS-Papers/papers/vehicle-platoon-review) - 当前阶段与下一步
- 项目风险与阻塞
- 可恢复的简要上下文
不再要求所有项目硬塞 Prompt/Plan/Implement/Documentation 四文件。若项目仓库已有成熟 PROJECT_STATUS/HANDOFF,仓内文档优先权更高。
3. 旧的“今日日志”改为“可执行的任务快照”
现在的长期交接里,daily todo 更依赖于 personal-llm-wiki/wiki/_meta/maintenance/daily-todo-registry.md + cron 推送。
它负责“今天要推进什么”,不是托管项目真相。
更新后的实践结构
一、项目管理页(个人库)
- 路径:
personal-llm-wiki/wiki/projects/<slug>.md - 作用:
- 让 Hermes/Human 快速确认项目边界
- 保证 daily todo 可抽取
- 固化项目主源路径(避免跨会话跑错目录)
二、仓库真相页(实施层)
在对应项目仓库内,优先看:
PROJECT_STATUS.md(当前状态)HANDOFF.md(会话级交接)NEXT-SESSION-START.md(下一次接手建议)docs/CURRENT_PLAN.md(若存在)
三、会话交接(可追溯)
每次结束补写:
- 这次决策与产出
- 哪些文件变更(可定位)
- 下一轮最优先的 1–3 条任务
- 未清风险与验证口径
同时补上 omx 会话记录(如 .omx/wiki/session-log-*.md)以便全局检索。
具体启动 / 收尾
启动(续接一句)
我只需要说:
继续推进 vehicle-platoon-review继续 security-state-aware-mixed-platoon先处理 yxj-wiki 仓库维护
然后执行顺序为:
- 读
personal-llm-wiki/wiki/projects/<slug>.md - 读项目仓库的
PROJECT_STATUS.md/HANDOFF.md - 读
NEXT-SESSION-START.md(有的话) - 读最近相关
omx会话记录
收尾(交接一句)
我只需要说:
今天先到这里,补一条交接先把状态写清楚,别丢风险
然后同步:
- 仓库
HANDOFF.md(本轮 done / 下一步) - 仓库
PROJECT_STATUS.md(状态演进) personal-llm-wiki项目页(关键口径更新)- 生成/补齐会话交接记录(本地检索面)
为什么这么改
这不是为了“更花哨”,而是为了减少下面的问题:
- 项目真相与管理记忆混淆
- 某些旧日志过期但被当作当前依据
- 各层文件更新节奏不一致导致续接误差
更新后,续接路径更短:先查个人库确认方向,再下仓库确认真相,最后写交接留痕。
如果你愿意,我下一步可以再给一版 “可直接粘贴给自己使用的模板清单”(包括PROJECT_STATUS.md与NEXT-SESSION-START.md的最小字段)。
我的长期 AI 工作流交接:从 Obsidian 迁移到 Hermes/Codex/OMX
https://weathour.github.io/posts/codex-obsidian-handoff-workflow/