用途
spec-loop 用于把一份已经通过审批、且同时具备 design.md 与 plan.json 的 Spec 计划,在无人值守的情况下执行到“草稿 PR”阶段。主智能体只负责驱动流程,实现与审查都交给每次新起的子智能体。该技能不做设计决策:需要变更计划的问题退回 spec-plan,需要变更设计的问题退回 spec-brainstorm。
主要能力
- 按 plan.json 顺序选任务,每批最多 5 个,要求依赖已完成或在同批更早位置。
- 每个任务由独立的新子智能体依次实现,使用 code-subagents 的 Sequential 模式与 references/implementor-prompt.md,并按任务 files 设置 OWNED_FILES。
- 每批执行 code-subagents Batch Review,并校验任务测试、完整测试套件、lint 与类型检查。
- 每批提交一次、最终修复后再提交,提交后更新进度追踪。
- 结束时整体执行 spec-finish,并进行一次 whole-branch 代码审查;推送前扫描各提交是否含密钥。
- 最终打开草稿 PR,报告完成摘要。
使用方式
启动时(包括恢复运行)会先检查:若 design.md 或 plan.json 缺失则停止并改用 spec-implement;否则在人工在场时按 spec-implement 的前置条件与“Load and Review the Plan”执行;工作树不干净或测试未全绿则停止。随后用一个授权问题逐项列明操作,取得 code-commit 与 code-pull-request 所需的显式授权。
循环阶段反复执行直到所有任务完成或预算耗尽:选题、逐任务实现、批审查与校验、提交并更新追踪、输出一行简报(如 Batch 2/5: T4, T7 done)。若任务返回 BLOCKED,则对被阻塞任务的路径执行 git stash push,在报告中给出 stash 引用并停止,不提交不完整批次。
完成阶段整体运行 spec-finish,并按既定策略处理原本会询问人工的环节:先用 code-commit 提交 simplify 编辑;审查使用一次 whole-branch 的 code-review rq,审查返回前保持工作树不变;仅对标记为 Mechanical: Yes 且 Requires user approval: No、且没有重新打开决策的发现自动修复。遇到阻塞性发现、需用户批准的发现,或需要改动 plan.json/design.md 的情况,停止且不推送。推送前用 gitleaks(如已安装)或模式扫描检查 base..HEAD 每个提交,命中即停止。最后要求“Ready for PR: yes”后打开草稿 PR。
适用场景
适用于已有获批 Spec 计划、希望减少人工介入、把实现推进到草稿 PR 的工程任务,尤其是需要分批实施、逐批审查并保留可恢复进度的场景。
限制
- 仅在 design.md 与 plan.json 同时存在时运行,否则应改用 spec-implement。
- 不做设计决策,计划或设计变更需回到上游技能。
- 工作树不干净或测试未全绿不启动。
- 预算:批次上限为计划任务数除以 3 向上取整再加 1;同一任务或测试失败两次即停止。
- 成本:每批一个批审查者,结束时一次整分支辩论式审查,约 8-12 个子智能体。
- 排除:合并、把 PR 标记为就绪、重写历史。
- 恢复依赖进度追踪;没有追踪器时需在启动阶段说明停止后无法恢复。