从方案到任务
将方案转换为implement代理可以遵循并勾选的、可执行的任务列表。
- 每个工作项位于
docs/specs/<YYYYMMDD>-<类型>-<名称>/。 tasks.md没有状态:其进度由[x]复选框体现。
开始之前
-
确定工作项,并阅读
plan.md和spec.md。 -
门控: 如果方案不具有
status: approved,则停止并询问:方案的状态是
<status>。我是否继续,还是先用review-spec审查,或者您现在批准它?仅当得到明确回答后才继续。对于没有方案的小变更,门控适用于规范。
-
阅读
AGENTS.md中“Commands”(西班牙语项目中为“Comandos”)部分的验证命令。如果没有,则询问它是什么,或者在收尾任务中留下警告。
如何拆分
- 小任务:每个任务都是一次可审查的变更,且项目保持绿色状态。
- 按依赖关系排序。用
[P]标记那些可以与上一个任务并行完成的任务。 - 每个任务列出其影响的文件(如果知道的话),以及如何验证:哪个测试,或哪个命令。
- 如果项目采用 TDD(
CONTRIBUTING.md或AGENTS.md会说明),则测试应放在代码之前或同一任务中,绝不能放在末尾。 - 必须至少用一个任务覆盖规范的每一个验收准则以及来自安全团队的每个负向测试。如果某个准则未被覆盖,请明确指出。
- 收尾阶段是强制的:验收准则通过测试,并且验证命令绿灯。
- 不要添加方案中没有的工作。如果方案中缺少某些内容,请作为问题提出。
结果
- 从
assets/tasks-template.md草拟tasks.md。 - 展示草稿,包括:
- 任务;
- 并行分组;
- 验证点;
- 任何遗留的问题。
- 只有获得批准后才写入文件。
- 建议的下一步:使用
implement代理来实施。