implement-with-subagents

使用子 Agent 实施

协调已批准的待办工作，同时掌握权限、顺序、验证、恢复和验收。为每个工作项分配一个全新的子 Agent，但在唯一的验收分支上，同一时间只允许一个会修改内容的 Agent。

在 $to-product 下，其自主契约会提供负责人审批和阻塞项策略。将该契约以及任何运行记录路径传递给每份任务说明。

仅对符合条件的只读问题或无副作用检查使用 $parallel-execution。绝不并发运行实施工作者。

输入

要求提供一个明确授权的范围：一个有效的 EPIC-NNN/路径（授权其所有已批准的子项及 Epic 关闭），或一组非空的 WORK-NNN ID/路径。对话中已明确建立且没有歧义的范围也算有效；否则，列出候选项并询问——绝不根据相似标题、变更路径或排名相邻关系推断一组工作项。工作项集合绝不授权兄弟项、父项、范围外依赖项或 Epic 关闭；Epic 提供协调上下文，但绝不会扩大某个子项的已批准结果范围。

可选的 model 和 reasoning effort 设置用于选择实施层级。除非用户要求统一设置，否则保留 $parallel-execution 的只读路由。如果某个界面无法应用某项设置，只需报告一次，并使用其默认设置。

预检

在派生子 Agent 或修改待办项之前：

1. 确定仓库指令，并要求使用当前的 setup-project 脚手架，包括 Epic 验收单元和批次证据维护规则。旧版项目应在委派前转到 $setup-project。
2. 运行 node scripts/validate-project.mjs；若基线无效，则停止。
3. 读取完整的授权记录、排名、关系、认领、索引、wiki 引用及最近索引、维护信息、研究资料、适用指南、受影响代码和测试；整合成一份权限信息包。仅当存在一个在此处无法轻易解答的具体未决问题时，才派遣只读协助；绝不进行泛泛的代码、测试、指南或风险清单盘点。
4. 检查分支、远程仓库、变更和近期历史。遵守 $create-conventional-branch 的不变量。保留无关工作。将主提交固定为不可变的 Epic 固定点。
5. 拒绝提议中的或格式错误的工作项、缺少排名/就绪状态的工作项、不一致或外部认领，以及范围外阻塞项。在 $to-product 之外，绝不添加、重新排名、取消、重新归属或更改范围；在其下，通过 $backlog 修复 PRD 要求的工作流状态，重新验证后再继续。

对于 Epic，将其临时顺序、依赖项、共享接口和冲突域与当前代码进行比较。每个子项完成后都要重新验证。

执行拓扑

Epic

1. 调用一次 $create-conventional-branch，然后应用 $implement 的单次开始/认领事务，处理 Epic 及其必需子项。
2. 将下一个可执行子项交给一个全新的子 Agent，并附上内部临时子项信息包，注明当前分支和 HEAD。管理者不得并发修改。工作者负责实施、直接提交、运行针对性检查和冒烟验证，然后返回证据，不进行审查或治理变更。
3. 验证其提交和证据，重新确认其可执行性，然后派遣下一个子项。绝不让同一个工作者再次处理其他工作项，也绝不提前启动有依赖关系的子项。
4. 所有子项都处于临时状态后，按照 $implement 完成 Epic 关闭：进行一次审查、直接检查补救措施、运行一套有代表性的测试套件及有充分理由的测试矩阵、进行一次协调核对、执行一次合并、发布验收状态，并完成一次原子化的最终事务。

任何子项都不得拥有分支、主合并或终态。不要逐个提交子项证据，也不要维护另一份任务文档。

独立 WORK 集

按顺序处理各项。对于每项，打开其唯一的验收分支并启动事务，然后向一名新的子 Agent 提供内部临时独立任务包，注明当前分支和 HEAD。管理者不得并发修改。核实返回的提交／证据后，在此处恢复 $implement WORK-NNN，进行审核、套件、合并、协调、最终事务和分支移除。绝不重复使用同一名工作者。

没有可用工作者时，在 $to-product 之外停止。在其下记录不可用的工作者，并立即在此处运行顶层 $implement；绝不要把产能作为阻碍上报。

验证与恢复

核实引用的提交、合并祖先关系、声明、排名、状态、索引、归档、审核模式、针对性检查、套件时效性、矩阵理由、协调和验收。信任新鲜且一致的证据；仅当证据缺失、过时、相互矛盾，或影响代码的集成输入存在差异时才重新运行。

对于 Epic，要求一个验收分支和一次合并；所有子项在原子式完成前均为临时状态；恰好一次全面审核；不得进行子项／修复审核；一个代表性套件；有理据的矩阵扩展或完整发布矩阵；一次 wiki/ADR 事务；以及恰好一次正常启动事务和一次最终待办事务。

通过同一名工作者重试无效或不完整的结果，并提供针对性证据。在 $to-product 下，工作流失败须在此处修复或在本地运行；只有技术故障才可尝试三次。然后遵循 $create-conventional-branch 的暂存协议，释放认领，将未完成记录恢复为 ready，并继续处理独立结果。绝不接受部分完成的 Epic 状态，也不得更改其他执行者的认领。

Epic 关闭

只有明确的 Epic 输入才授权关闭。遵循 $implement 和其 Epic 参考文档；不得添加编排器专属的审核、套件、合并、协调或完成关卡。关闭报告和仓库证据必须显示单一共享验收事务集。

调用示例

Use $implement-with-subagents with EPIC-012.
Use $implement-with-subagents for WORK-014, WORK-019, and docs/backlog/standalone/WORK-023-fix-export.md.
Use $implement-with-subagents with EPIC-012 using model gpt-5.6-sol and reasoning effort high.

最终报告

报告子项顺序；Agent 和回退方案；使用或不支持的模型／工作量；验收分支；提交和针对性证据；审核；验收合并；协调／ADR；事务；最终认领／排名／状态／归档状态；已披露的墙钟时间／令牌用量；以及阻碍。即使跳过或没有相关内容，也必须包含准确的 Representative suite: 和 Retries, conflicts, rework: 两行。

以 Next step: 结尾——若受阻，提供准确的恢复命令；否则使用 $implement-with-subagents 或 $implement 并注明排名最高的下一个范围，或使用 $discuss 并注明下一个未解决结果。