让 coding agent 按任务清单逐项推进

可以得到什么

把一次变更拆成可逐项推进的 tasks，让 coding agent（如 Claude Code、tools/Codex-CLI）按清单一项一项执行并验证，避免一次性提出"实现整个功能"导致的范围与质量失控。

适合哪些情况

• 跨文件、需多步协调的实现。
• 需要明确每一步完成标准的中大型功能。
• 多人或多个 Agent 会话协作时需要可追踪的进度。
• 容易被 Agent 跳过边界或自我"宣布完成"的任务。

需要准备什么

• 已写好的 proposal、spec、design（见 把模糊需求整理成可验收的规格）。
• 项目测试与运行方式。
• 当前任务上下文（CLAUDE.md 项目级指令文件（Claude Code 项目宪法） 等项目级指令可作底座）。

常见做法

1. 从 spec 与 design 出发，把实现拆为有序的 tasks。
2. 每条 task 写明：目标、修改文件、验收条件（最好对应 spec 中的某条验收）。
3. 让 Agent 一项一项执行；每完成一项先运行测试，再对照 spec 验收。
4. 失败时回到对应 task 修改，而不是让 Agent 整体重做。
5. 全部 task 通过后，进入变更归档环节（见 为 AI 开发项目保留决策与实施历史）。

真实案例与教程

• OpenSpec-practise：示范 tasks 列表的写法与按项验收流程。
• 规格驱动开发（Spec-driven development）配合 AI 助手：完整方法描述。

限制和检查点

• 任务拆得过细会增加维护成本；过粗则失去"按项验收"的意义。
• 验收环节仍需运行测试，不能只看 Agent 自报"已完成"——见 规格驱动开发中规格错误被稳定放大的风险。
• 跨多个 Agent / 多个会话协作时，task 状态需要在仓库中可追踪（例如写入文档或 issue）。
• 与 Claude Code Subagents 多 Agent 协作与统一主计划 协作时，需在统一 plan 下分配 task，避免子 agent 各做一份。

相关任务

• 把模糊需求整理成可验收的规格
• 为 AI 开发项目保留决策与实施历史

来源

来源：OpenSpec-practise，作者 ForceInjection。