大家好,我是云途。
十分钟能做完的小任务,通常不用专门保存进度。17 篇课程、整套官网或一次系统迁移,会跨越很多步骤,也可能要换几个对话才能完成。
这类任务暂停前,要写清楚哪些已经完成、哪些还只是计划、哪些检查失败,以及下一步应该先做什么。
这节课会分别介绍计划、阶段记录、工作区状态和接力说明。学会以后,即使任务中断,你也能从正确位置继续。
这节课要完成什么
- 把长目标拆成有依赖关系的阶段;
- 同一时间只保留一个进行中步骤;
- 在关键变化后建立检查点;
- 把事实同步到项目状态文件;
- 写出陌生协作者也能继续的接力说明。
计划描述任务状态,不是愿望清单
[完成] 核验官方资料与课程结构
[完成] 建立共享课程数据和树状目录
[进行] 完成第 03—17 节正文与路由
[待办] 运行全部构建、路由和浏览器验证
[待办] 更新课程计划与工作区状态每个步骤要能判断完成与否。像“继续优化”“处理细节”无法作为可靠状态;应写成具体交付与证据。
按照依赖关系排序
先事实
官方能力、业务内容、版本边界与真源。
再结构
数据模型、路由、共享组件与目录层级。
再内容
在稳定结构中填充文章、图片和状态。
后验证
局部闭环后做全量构建、交互、响应式和回归。
最后记录
把最终事实同步到计划、README、设计系统和工作区状态。
什么时候应该保存一次阶段记录
- 完成了一个可以独立运行的阶段;
- 准备执行风险较高、难以恢复的操作;
- 用户确认了会影响后续工作的设计或业务选择;
- 测试全部通过,准备进入下一部分;
- 对话可能中断或需要交给别人继续;
- 遇到阻塞,需要等待外部信息。
这种阶段记录也叫“检查点”。至少要写下当前文件状态、检查结果、剩余事项和下一步入口。代码项目可以配合 Git 提交,内容项目可以保存一个写明版本的文件。
计划和工作区状态各自负责什么
计划
服务当前任务,颗粒度较细,随执行不断更新。
工作区状态
服务后续所有对话,只记录重要结论、路径、验证和待办。
AGENTS.md
保存稳定执行规则,不记录今天进行到第几步。
交付报告
说明本轮最终做了什么以及证据,不代替长期状态。
接力说明要让陌生人也能继续
## 目标
最终要完成什么。
## 已确认决定
用户已冻结的结构、文案、视觉和边界。
## 已完成
文件、路由、测试和证据。
## 当前状态
唯一进行中的步骤与真实结果。
## 未完成
按依赖排序的后续工作。
## 风险与禁止项
不能误做的版本、数据和外部动作。
## 下一步入口
先读哪些文件,运行什么命令。接力只写事实,不伪造完成
- “已写代码”与“已验证页面”分开;
- “测试通过”列出具体命令和时间;
- “用户确认”只记录明确确认过的内容;
- 尚未浏览或未核对的内容标为待办;
- 失败原因与临时绕过如实记录;
- 不要把原计划自动改写成已完成。
让 Codex 在长任务中持续维护状态
可复制提示词
请先建立 4—7 步执行计划,同一时间只标记一个步骤为进行中。每完成一个可独立验证的阶段,更新计划并记录文件、命令、结果与未覆盖项。重要版本、路径、设计决定和最终测试同步到工作区状态。任务结束时生成接力说明,明确已完成、进行中、未完成、风险和下一步入口,不把未验证工作写成完成。
视频录制与复习提纲
- 把 17 节课程目标拆成五步计划;
- 按依赖调整错误顺序;
- 在共享目录完成后建立检查点;
- 区分计划、AGENTS.md 和状态文件;
- 模拟对话中断并写接力说明;
- 让新对话只读接力后复述下一步。
任务可以中断,但状态不能含糊
- 计划步骤有清楚完成条件;
- 同一时间只有一个进行中步骤;
- 关键阶段保存了文件与验证检查点;
- 长期事实已经更新到工作区状态;
- 接力区分已完成与未验证;
- 下一步入口包含路径、文件和命令。