Codex 长任务怎么拆？用计划、进度记录和测试逐段验收

适用范围与核对日期

AIXiamo（AI夏末）于 2026 年 10 月 5 日按 OpenAI 官方文档整理。下面的任务列表、里程碑和记录模板是本文设计的教学示例，不是客户案例，也不是已在读者项目运行的测试结果。命令、权限和环境均以实际使用的 Codex 界面为准。

OpenAI 的长任务说明强调明确结果、约束和完成标准；本文把这些原则转为可以逐段核对的工作流程，不承诺减少固定比例的消耗或提升固定比例的成功率。

教学例子：为已有任务列表增加“只看未完成”筛选

这个例子的完成标准是：可以切换全部与未完成任务；筛选后新增、标记完成和删除仍按原有规则运行；没有匹配项时正确显示空状态。保留已有布局和数据存储方式，不顺手改登录、计费或整个界面。

先让 Codex 检查现有实现和测试工具，再确认下面四段是否适合项目。如果项目已经具备某一步，直接沿用，不为凑流程重写。

• 第 1 段：确认当前新增、完成、删除和空列表行为，记录已有测试结果与已知失败。
• 第 2 段：实现筛选逻辑，按现有测试框架覆盖全部、部分未完成、全部完成和空列表。
• 第 3 段：把筛选接入现有界面，检查切换状态、空状态和原有操作，不改页面整体布局。
• 第 4 段：运行相关测试与项目构建，实际验证筛选后的新增、完成、删除，汇总 diff 和剩余问题。

可直接使用的起始请求

把功能名称和约束换成自己的需求。下面明确要求先出计划、等确认后再改代码；自动运行、部署或修改外部系统的权限不由这个模板授予。

先只检查项目并提出计划，不修改代码。
目标：为现有任务列表增加“只看未完成”筛选。
保持原有新增、完成和删除行为，不重写界面。
把工作拆成可独立验证的里程碑，列出实际存在的验证命令。
我确认计划后再开始；每段验证失败先修复。
每段结束更新 TASK_PROGRESS.md，写明证据与下一步。

进度文件模板：事实、待确认和下一步分开写

TASK_PROGRESS.md 是自定义普通文件，名称可以替换；不会因为文件存在就自动加载。让 Codex 在每段结束更新它，恢复时明确要求读取，并检查 git diff 与文件现状。它不能代替代码、日志或测试。

下面均为待填写的示例字段，测试结果必须来自实际执行。记录只放必要的命令和结论，不写 API Key、登录令牌、客户身份或完整业务数据；提交前审阅，敏感日志留在自己的非公开环境。

# Task Progress

目标：为现有任务列表增加未完成筛选
约束：保留原有操作和布局，不改数据存储
当前阶段：待填写

## 已完成
- 修改文件：待填写
- 验证命令或操作：待填写
- 实际结果与证据：待填写

## 尚未验证
- 未执行检查及原因：待填写
- 待确认问题：待填写

## 下一步
- 下一段范围与验收条件：待填写

上下文压缩或换会话后，先核对再继续

当前 Codex CLI 与应用的 /compact 用于压缩会话上下文，不会恢复已经消耗的会员额度。压缩前先更新进度记录；它也不保证旧细节都可逐字保留，重要约束应落实到可读取的记录中。

同一项相关工作通常放在同一会话更容易保持连续性。确实换会话时，先确认仍是同一个 checkout；要求读取记录和项目指令，检查当前 diff，必要时重跑上一段关键验证。记录与实际状态冲突时先解释差异，不照着旧的“已完成”继续。

先读取项目指令和 TASK_PROGRESS.md，不立即修改代码。
核对当前 checkout、git diff 与上一段实际验证结果。
列出记录和代码不一致的地方，以及尚未完成的验收。
确认当前阶段后，只继续下一段约定范围。

代码审查和用量检查，不能代替验收

支持的 Codex 界面可用 /review 辅助检查变更，但审查不是测试通过证明。最后仍要按项目实际工具执行检查，并把未运行项明确留在报告里。

如果是用量受限，应另查当前 Usage、应用限制和明确报错。先确定是上下文、测试、权限还是额度问题，不把长任务未完成直接等同于 Plus 不够；升级 Pro 也不能保证任意长任务完成。