模块 4 · 建立长期协作方式

用计划、检查点和接力说明
推进长任务

长任务暂停以前,把已经完成、正在进行和下一步写清楚,下一次就能接着做。

预计阅读 28 分钟视频建议 24—30 分钟登录后免费核验于 2026.08.18

大家好,我是云途。

十分钟能做完的小任务,通常不用专门保存进度。17 篇课程、整套官网或一次系统迁移,会跨越很多步骤,也可能要换几个对话才能完成。

这类任务暂停前,要写清楚哪些已经完成、哪些还只是计划、哪些检查失败,以及下一步应该先做什么。

这节课会分别介绍计划、阶段记录、工作区状态和接力说明。学会以后,即使任务中断,你也能从正确位置继续。

这节课要完成什么

  1. 把长目标拆成有依赖关系的阶段;
  2. 同一时间只保留一个进行中步骤;
  3. 在关键变化后建立检查点;
  4. 把事实同步到项目状态文件;
  5. 写出陌生协作者也能继续的接力说明。

计划描述任务状态,不是愿望清单

五步计划示例PLAN
[完成] 核验官方资料与课程结构
[完成] 建立共享课程数据和树状目录
[进行] 完成第 03—17 节正文与路由
[待办] 运行全部构建、路由和浏览器验证
[待办] 更新课程计划与工作区状态

每个步骤要能判断完成与否。像“继续优化”“处理细节”无法作为可靠状态;应写成具体交付与证据。

按照依赖关系排序

先事实

官方能力、业务内容、版本边界与真源。

再结构

数据模型、路由、共享组件与目录层级。

再内容

在稳定结构中填充文章、图片和状态。

后验证

局部闭环后做全量构建、交互、响应式和回归。

最后记录

把最终事实同步到计划、README、设计系统和工作区状态。

什么时候应该保存一次阶段记录

  1. 完成了一个可以独立运行的阶段;
  2. 准备执行风险较高、难以恢复的操作;
  3. 用户确认了会影响后续工作的设计或业务选择;
  4. 测试全部通过,准备进入下一部分;
  5. 对话可能中断或需要交给别人继续;
  6. 遇到阻塞,需要等待外部信息。

这种阶段记录也叫“检查点”。至少要写下当前文件状态、检查结果、剩余事项和下一步入口。代码项目可以配合 Git 提交,内容项目可以保存一个写明版本的文件。

计划和工作区状态各自负责什么

计划

服务当前任务,颗粒度较细,随执行不断更新。

工作区状态

服务后续所有对话,只记录重要结论、路径、验证和待办。

AGENTS.md

保存稳定执行规则,不记录今天进行到第几步。

交付报告

说明本轮最终做了什么以及证据,不代替长期状态。

接力说明要让陌生人也能继续

接力说明模板MARKDOWN
## 目标
最终要完成什么。

## 已确认决定
用户已冻结的结构、文案、视觉和边界。

## 已完成
文件、路由、测试和证据。

## 当前状态
唯一进行中的步骤与真实结果。

## 未完成
按依赖排序的后续工作。

## 风险与禁止项
不能误做的版本、数据和外部动作。

## 下一步入口
先读哪些文件,运行什么命令。

接力只写事实,不伪造完成

  1. “已写代码”与“已验证页面”分开;
  2. “测试通过”列出具体命令和时间;
  3. “用户确认”只记录明确确认过的内容;
  4. 尚未浏览或未核对的内容标为待办;
  5. 失败原因与临时绕过如实记录;
  6. 不要把原计划自动改写成已完成。

让 Codex 在长任务中持续维护状态

可复制提示词

请先建立 4—7 步执行计划,同一时间只标记一个步骤为进行中。每完成一个可独立验证的阶段,更新计划并记录文件、命令、结果与未覆盖项。重要版本、路径、设计决定和最终测试同步到工作区状态。任务结束时生成接力说明,明确已完成、进行中、未完成、风险和下一步入口,不把未验证工作写成完成。

视频录制与复习提纲

  1. 把 17 节课程目标拆成五步计划;
  2. 按依赖调整错误顺序;
  3. 在共享目录完成后建立检查点;
  4. 区分计划、AGENTS.md 和状态文件;
  5. 模拟对话中断并写接力说明;
  6. 让新对话只读接力后复述下一步。
完成检查

任务可以中断,但状态不能含糊

  • 计划步骤有清楚完成条件;
  • 同一时间只有一个进行中步骤;
  • 关键阶段保存了文件与验证检查点;
  • 长期事实已经更新到工作区状态;
  • 接力区分已完成与未验证;
  • 下一步入口包含路径、文件和命令。

官方依据与延伸阅读

Codex 使用案例:长任务与自动化