Codex 高级用法：工程协作工作流 · 处理中断并复用闭环
从一次成功到稳定复用：复盘完整协作闭环
用现有文章、状态、审阅和修订记录复盘 Codex 协作链路，区分可迁移的判断与模板、必须在新仓库重做的事实，并整理下一任务的最小启动包。
一套工作流连续推进到第十二篇文章，很容易让人产生错觉：既然流程能跑，模板就已经成熟，可以原样复制到所有项目。
磁盘上的材料给出了更克制的结论。前十一篇都经历了独立审阅，四篇需要修订后复审；项目规则、角色、交接、验证和恢复演练都有真实文件支撑。但这次贯穿对象仍是 JVS 内容生产流程，并没有在另一个真实业务仓库完成一次功能修改或重构。配图和发布也没有进入本轮授权范围。
小编现阶段的判断是：可复用的不是这套目录本身，而是它反复证明有效的判断顺序、产物契约和失败处理方式。仓库事实、风险、命令与完成证据，到了新任务必须重新调查。
一、先复盘实际发生了什么
本系列从受控工作区开始，经过计划与授权、Skill 与 Agent、交接、证据执行、独立验收，最后做了一次检查点恢复演练。下面这张表只记录当前文件能够支持的结论。
| 阶段 | 当前项目的真实产物 | 可以核对的结果 | 暴露的问题 | 复盘判断 |
|---|---|---|---|---|
| 受控工作区 | 项目 AGENTS.md、上下文分层方法、01 章正文与报告 | 01-01、01-02 在 topic.md 中为 reviewed | 01-01 首审发现操作语境混淆和验证记录不足 | 常驻规则要少而稳定，操作入口和验证证据必须落到实际环境 |
| 计划、门禁与权限 | topic.md 的文章地图、状态、依赖，02 章的计划/门禁/权限矩阵 | 02-01 至 02-03 均有正文和通过报告 | 未出现返工不等于规则可以照搬到其他仓库 | 目标、未知项、授权与影响面是稳定判断；具体工具和权限必须重查 |
| Skill、Agent 与交接 | jvs-write、jvs-review、三份 Agent TOML、项目交接契约 | 03 章三篇均进入 reviewed | 03-01 的决策树混淆复用与职责隔离；03-02 错写 custom agent 识别机制 | Skill 复用方法，Agent 分离责任；产品配置事实需要版本核验 |
| 证据执行与独立验收 | 04-01 受控实现记录、04-02 验证矩阵和证据包、对应审阅报告 | 两篇均有独立报告；04-02 修订后复审通过 | 04-02 的证据枚举一度无法表达差异检查 | 每条结论都要标明方法、范围、结果和未覆盖项；模板本身也要接受审查 |
| 检查点恢复 | 05-01 检查点与只读恢复演练 | 目标文件、两处状态和前置审阅结果可从磁盘重建，演练没有重复写入 | 演练没有制造真实崩溃或外部请求半成功 | 恢复先核事实与授权；高风险副作用仍需在对应项目单独演练 |
审阅记录比“十一篇全部通过”更有信息。01-01、03-01、03-02 和 04-02 都经历了首审退回，共留下五个已解决问题：操作语境、验证记录、Skill/Agent 选型轴、custom agent 配置事实和差异检查枚举。它们分别暴露了环境混用、证据缺口、模型设计错误、易变事实误写和模板接口不闭合。
这也说明独立审查的价值并不只在挑文字。它迫使实现者重新读取实际配置、官方资料、状态和模板字段。问题修正后再复审，reviewed 才有证据支撑。
二、哪些可以带走，哪些必须重做
迁移工作流时，先把内容分成三类，能避免把整个 JVS 项目复制成一套越来越重的“万能模板”。
2.1 可以跨任务复用的原则
- 开工前先读仓库事实，再解释用户需求；
- 计划记录目标、非目标、依赖、风险、状态和完成条件；
- 目标变化、影响面扩大或难恢复动作进入确认门禁；
- 工具能力不等于任务授权，操作范围遵循最小充分；
- Skill 保存稳定方法，Agent 只为独立责任、上下文或产物而拆；
- 角色交接携带路径、授权、状态、证据、风险和返回条件；
- 完成声明由验证矩阵和独立审查重新判断；
- 中断后从磁盘与外部对象重建现场，未核验前不重复副作用动作。
这些原则描述判断顺序，没有绑定 JVS 的文件名、文章状态或三角色设置。换成代码重构、数据处理或发布任务，仍然可以用它们判断下一步。
2.2 可以复用、但需要填值的模板
本系列已经形成几种可带到新任务的结构：上下文路由表、任务计划、确认门禁表、工具权限矩阵、角色卡、交接契约、受控实现记录、验证矩阵、证据包和恢复检查点。
模板只能保留字段和校验关系。例如交接契约可以继续要求目标、路径、授权和风险，却不能预填 /Users/abm/AI-DEV/jvs；验证记录可以保留 method、scope、result 和 uncovered，不能预写测试命令或“通过”。模板中的示例值进入新仓库前应全部清空或重新核验。
2.3 每个仓库必须重新调查的事实
- 目录结构、技术栈、生成文件和真实事实来源；
- 安装、启动、测试、构建、格式化和发布命令；
- 凭据、网络、数据、外部系统和破坏性操作的风险；
- 当前工作区差异、并发修改和文件所有权；
- 任务完成条件、测试覆盖和人工验收路径；
- 哪些职责真的需要 Skill 或 Agent，哪些保持单 Agent 更简单；
- 当前 Codex 版本下易变的配置、权限和产品行为。
这些内容一旦预填，工作流就会把旧项目经验伪装成新项目事实。迁移时最值得删除的，往往正是看起来最“完整”的默认值。
三、用迁移检查表约束下一次复制
下面的检查表用于把本系列方法带到另一个任务。它不要求一次建立所有角色和模板，先回答能改变开工决策的问题。
- 已从目标仓库重新读取目录、技术栈、运行方式和禁止修改对象；
- 已把用户目标写成可检查结果，并列出明确非目标；
- 已分开事实、假设、用户选择和待验证项；
- 已为每个阶段写出依赖、状态、风险和完成证据；
- 已标出需要确认的方案分叉、范围扩张、外部写入和难恢复动作；
- 已按证据需求选择工具，并解析准确文件、仓库或远端对象；
- 只有稳定重复的方法才进入 Skill，只有独立责任才拆 Agent；
- 交接能够让接收者仅凭路径和状态重新核对现场；
- 验证矩阵覆盖关键完成条件，并记录未运行与不适用项；
- 独立审查者会重新读取事实，不沿用实现者的通过声明；
- 检查点写明未知副作用、下一安全动作和禁止重复动作；
- 已删除来自旧项目的路径、命令、角色和成功结论。
列表中任一项暂时不需要，可以写明原因后省略产物。例如一次低风险、单文件、可立即验证的修改，未必需要专业 Agent 和完整交接契约。复用要降低失控风险，无需让每个任务都走十二篇文章描述的全部流程。
四、下一任务的最小启动包
新任务不应从复制整个 codex-advanced-usage 目录开始。一个中等复杂、会修改真实仓库的任务，可以先准备下面四份轻量对象。
11. 仓库规则入口
2 - 稳定技术事实
3 - 禁止修改对象
4 - 真实测试/构建入口
5
62. 当前任务卡
7 - 目标与非目标
8 - 已知事实、假设、待验证项
9 - 阶段、依赖、状态和完成条件
10 - 授权范围与确认门禁
11
123. 执行与验证记录
13 - 基线和允许变更范围
14 - 实际动作、差异与偏差
15 - 静态检查、测试、构建、人工核验
16 - 每项证据的范围、结果和未覆盖项
17
184. 恢复检查点
19 - 当前文件、状态和已完成证据
20 - 失败点与未知副作用
21 - 下一安全动作和禁止重复动作Skill、专业 Agent 和独立审查角色按任务形状再加。方法会重复且边界稳定时创建或调用 Skill；需要隔离判断、上下文或产物时配置 Agent；风险足以让实现者自审失去独立性时安排审查角色。这些组件按问题增加，不作为启动包的固定数量指标。
这个启动包还缺少新任务的真实内容。正式开工前，至少要补齐下面这份最小实例：
1next_task:
2 repository: 待选择并核验的真实仓库绝对路径
3 objective: 一个可验收的中等复杂修改
4 non_goals: 明确不处理的相邻问题
5 source_of_truth: 需求、代码和状态的实际入口
6 allowed_changes: 用户授权的文件、模块和外部动作
7 confirmation_gates: 方案分叉、范围扩大、破坏性或外部操作
8 completion_conditions: 功能、范围、测试、构建和人工验收条件
9 independent_review: 审查对象、问题分级和放行规则
10 checkpoint_path: 中断后可以重新读取的任务记录目前这些值仍是待填项，因此不能宣称本系列已经完成真实业务代码改造。当前可以确认的是：JVS 写作任务已经用项目规则、计划、三角色协作、独立审阅、最小修订和恢复演练跑通一轮；下一任务是否可迁移，要等新的仓库事实填入启动包并完成一次小范围验证后再判断。
五、给本轮成果划一条真实边界
05-02 写入前，磁盘上有十一篇正文和十一份对应审阅报告，前十一项规划状态均为 reviewed。四份报告保留了修订—复审过程，五个问题最终标记为已解决。05-01 的恢复演练也记录了它只验证磁盘状态重建，没有模拟真实崩溃或外部副作用。
本轮自审与校验后的写作层快照如下：
1series_writing_snapshot:
2 planned_articles: 12
3 article_files: 12
4 topic_reviewed: 11
5 topic_drafted: 1
6 review_reports: 11
7 reviewed_reports_with_open_blocking_or_important: 0
8 resolved_review_items: 5
9 odd_code_fence_files: 0
10 trailing_whitespace_lines: 0
11 not_completed:
12 - 05-02 独立质检
13 - 全系列配图
14 - 全系列发布
15 - 在真实业务仓库完成并验收功能修改或重构这条边界比“工作流已经成熟”更有用。它说明哪些产物已经存在，哪些问题真的经过返工，哪些检查只覆盖写作结构，以及下一次验证还缺什么。稳定复用从这里开始：带走经过验证的判断和空模板，把旧路径、旧风险与旧结论留在原项目，再用一个新的真实任务检验它们是否仍然成立。