1709 字
9 分钟
我的 Codex × Obsidian 长周期交接工作流

过去一段时间,我一直在折腾一个问题:如果我以后主要和 Codex 交接工作,而不是自己维护一套复杂的项目系统,那我的研究工作流应该长什么样?

我最开始的做法,其实很像传统的“项目卡 + 日志 + 总览页”体系:项目区里放项目卡,日志区里放今日日志,再用几个总览页把任务拉出来看。这个体系不是不能用,但它有一个越来越明显的问题:

我总是在重复维护同一批信息。

项目目标写在项目卡里,今天做什么写在日志里,跨会话要继续时又得重新解释一遍。结果是,系统本身变成了负担。

这次我把它彻底收敛成了一套更轻的结构:项目四件套 + 今日日志 + 会话留档。核心目标只有一个:以后我只需要对 Codex 说一句“继续推进某个项目”,剩下的上下文恢复工作由 Codex 自己完成。

旧体系的问题#

旧体系的核心问题不是“没有记录”,而是记录太分散,而且重复

主要体现在三点:

  • 项目卡里有长期目标、下一步、waiting、项目任务;
  • 今日日志里又会重复写当天推进的项目和滚入任务;
  • 每次换一个新会话,还得再做一遍口头 handoff。

这会带来两个后果:

第一,真正重要的长期状态没有被压缩成一个稳定入口;第二,我每次开工前都还要自己重新组织上下文。

对于长周期研究工作来说,这样的流程太重了。

我现在采用的新结构#

现在我把整个工作流拆成三层:

  1. 项目长期记忆层
  2. 当天执行层
  3. 跨会话交接层

具体对应的文件结构是:

1. 项目长期记忆层:四件套#

每个活跃项目都维护四个文件:

  • Prompt.md
  • Plan.md
  • Implement.md
  • Documentation.md

它们各自分工很明确。

Prompt.md#

这里放相对稳定的信息:

  • 项目目标
  • 关键约束
  • 非目标
  • done 标准

也就是说,这个文件回答的是:这个项目到底为什么做、做到什么算结束。

Plan.md#

这里放阶段性推进结构:

  • 当前阶段
  • 里程碑
  • 当前 1–3 个下一步
  • 验证方式
  • stop rules

它回答的是:接下来这一段时间怎么推进。

Implement.md#

这里放 Codex 自己要遵守的交接协议:

  • 每次开始先读什么
  • 每次结束要更新什么
  • 哪类信息应该写到哪个文件
  • 什么内容不要乱放

它更像“项目自己的操作手册”。

Documentation.md#

这是最关键的一个文件,相当于项目当前状态的单页记忆

这里会保留:

  • 当前状态
  • 已知事实
  • 关键判断
  • 当前风险
  • 最近进展
  • 下一步

如果下次开工我只让 Codex 先读一个文件,那我会优先让它读这个。

2. 当天执行层:今日日志#

今日日志继续保留,但职责被大幅收缩。

它现在只负责写:

  • 我今天最重要的 3 件事
  • 我今天推进的项目
  • 我今天做了什么
  • 我今天的关键判断 / 卡点 / 反思
  • 我明天优先做什么
  • 下次需要 Codex 接着做什么

也就是说,今日日志只负责“今天”,不再承担长期项目主档案的角色。

3. 跨会话交接层:会话留档#

除了今日日志之外,我还保留一层单独的会话留档:

  • YYYY-MM-DD-会话NN.md

这里专门写给“下一个会话”的 handoff,内容包括:

  • 本次会话完成了什么
  • 修改了哪些文件
  • 形成了哪些关键判断
  • 还有哪些未完成 / 风险点
  • 下一次应该从哪里继续

这个文件的定位很明确:它不是长期项目档案,而是跨会话续接的桥。

这套流程怎么实际使用#

工作方式已经被我压缩得很简单。

开始工作时#

我以后只需要说一句:

  • 继续推进 YK-RL
  • 切到车辆队列中文综述
  • 继续昨天那个方向判断

然后 Codex 自己按顺序去读:

  1. 项目的 Documentation.md
  2. 项目的 Plan.md
  3. 最近一次相关会话留档
  4. 当天日志
  5. 必要时再读 Prompt.md

也就是说,我不再手工准备一长段交接背景。

结束工作时#

我只需要说:

  • 今天先到这里,帮我留档
  • 做个交接总结
  • 把今天状态记下来

然后 Codex 自己完成:

  1. 更新项目 Documentation.md
  2. 必要时更新 Plan.md
  3. 更新今日日志
  4. 写新的会话留档

这个改法为什么更适合我#

我现在的工作不是单个短任务,而是多个并行推进的长周期研究:例如一篇要收尾的论文、一篇要定边界的综述、一个准备转向的新研究方向。

这类工作真正需要的,不是更多表格,而是更稳定的可恢复上下文

新的结构更适合我的原因是:

  • 长期信息不再散落在项目卡、日志、口头补充里;
  • 当天执行和长期状态被拆开了;
  • 会话 handoff 有了专门的轻量层;
  • 我不再负责“整理上下文”,而是让 Codex 去读和压缩上下文。

本质上,这不是在“多记一点”,而是在做一件更重要的事:

把长期记忆、当天执行和跨会话交接彻底分层。

我清理掉了哪些旧东西#

为了让新流程真正生效,我也顺手删掉了几类旧式文件:

  • 旧的 00-项目总览.md
  • 旧的 00-日志总览.md
  • 旧的 project_card_template.md
  • 各项目里原本承担主流程功能的 写作计划.md

与此同时,原来的 项目卡.md 也不再承担大段主档案功能,而是被改成轻量入口页。

我只保留那些仍然有支持价值的材料,例如文献分类表、方向判断笔记、以及日常日志和会话留档。

结尾#

如果要用一句话概括这次调整,我会这样说:

我不再把项目管理当成“我要手工维护的一套系统”,而是把它变成“Codex 可以主动读取和续接的一组项目记忆文件”。

这套工作流并不追求复杂,而是追求一件事:下一次开始工作时,我只说一句话,系统就能自己接上。

接下来我会继续用这套结构跑几轮,看看它在实际长周期研究推进中还能怎么再压缩、再稳定。

我的 Codex × Obsidian 长周期交接工作流
https://weathour.github.io/posts/codex-obsidian-handoff-workflow/
作者
Weathour
发布于
2026-04-03
许可协议
CC BY-NC-SA 4.0