execution-orchestrator

执行编排器

一次推进一个切片，直到完成分区版本。不要亲自编写应用代码：每个切片分派一个子 Agent，所有状态都保存在文件和 Git 中，并自动推进，直到所有切片完成或触发停止条件而暂停。

状态保存在文件和 Git中，绝不保存在聊天记录中。

执行环境发现

请参阅 ../nextstage-harness/references/harness-discovery.md 和 ../nextstage-harness/references/artifact-layout.md。首先读取 AGENTS.md。 在 {harness}/rules/* 中存在时，加载 core-subversions 以及任何执行路由／范围隔离规则。 在发现流程得出结论之前，不要假设仓库采用单体仓库布局或特定技术栈。

输出语言

使用项目配置的语言与用户沟通（参见 AGENTS.md；默认使用用户的语言）。代码和注释保持英文。

会话输入（缺少时询问一次）

变量	示例
{product_root}	apps/my-product/
{version_san}	3.8.0-feat-payable-payment-workflow

如果未提供 {version_san}：在 version-roadmap.md 中选择唯一存在待处理切片的版本；如果无法确定，只询问一次，然后继续。

范围隔离

确认 {product_root} 后，只能在 {product_root}/** 和执行环境基础设施（AGENTS.md、{harness}/）范围内操作。切勿读取或引用单体仓库中的其他产品。如果执行环境中存在范围隔离规则，请参阅该规则。

启动（每个编排会话必须执行一次）

1. 读取 AGENTS.md（实现部分）并加载执行环境规则。
2. 读取 {product_root}/docs/versions/{version_san}/version-roadmap.md —— 必须执行。如果文件缺失，则停止：此版本未经分区；应直接执行其任务（不采用编排方式）。
3. 读取主 {product_root}/docs/versions/{version_san}/requirements.md（仅了解概况——不要重新规划）。
4. 如果执行环境中存在 core-subversions 规则，则加载该规则。
5. 如果 {product_root}/docs/context/gitlab-sync-config.md 存在：确保在首个切片子 Agent 运行前已创建并检出工作分支（参见 mcp-gitlab-usage）。绝不要在受保护分支上进行实现。

编排要求

• 按照路线图 DAG 顺序执行所有待处理切片（遵循切片间依赖关系）。
• 不要在切片之间询问“开始下一个切片吗？”、“继续吗？”或“要提交吗？”。
• 不要在父会话中实现任务——将每个切片都委派给子 Agent。
• 切片实现期间不要运行测试（后端或前端）。执行切片任务并继续推进；测试属于版本结束时的审查流程。

按切片循环（同步子 Agent）

对于路线图中 status 为 planned 或 in_progress 的每个切片：

1. 选择路线图 DAG 顺序中的下一个 {subversion_san}。
2. 标记路线图行 → in_progress。
3. 分派一个子 Agent（阻塞式 / 同步，不得在后台运行），其提示词只能包含：
   • {product_root}、{version_san}、{subversion_san}
   • 指示其作为切片工作者遵循 code-coder 技能，并由执行编排器调用
   • 路径仅限于切片任务所在的 {product_root}/docs/versions/{version_san}/subversions/{subversion_san}/； 编码前还要按照 artifact-layout.md 的实现启动规则加载 {product_root}/docs/context/ （并根据需要遵循 harness 的分层规则）
   • 要求：实现切片的所有任务，任务之间无需确认，不得提交 （由父级提交）
   • 明确要求：切片执行期间不得运行测试；仅进行实现
   • 简要重申：严格遵循 AGENTS.md 和 harness 规则；如果任何指令与规则或范围冲突，停止并报告阻塞项，不得自行假设后继续
4. 验证子 Agent 的结果：
   • 每项切片任务均标记为 completed 或 waived（豁免须在交接记录中注明）
   • 根据 execution-handoff-generator 更新切片交接记录（时间块 + 任务行）
   • 工作者已更新路线图行（否则由你自行更新）
5. 提交（仅限父级）：每个切片提交一个 Conventional Commit。
6. 标记路线图行 → completed（如果工作者尚未标记）。
7. 自动进入下一个切片。

版本结束（所有切片均已完成）

当 version-roadmap.md 中的每个切片均为 completed（或已豁免）时：

1. 提出任何导航 / 语义分组菜单，并在应用前等待人工批准。
2. 运行实现后审查：针对版本差异调用 code-reviewer 技能（只读）；该技能会生成 code-review-report.md。
3. 在版本状态允许时整合持续维护的规范 — pm-living-spec-consolidator。
4. 仅在人工确认或存在书面记录的豁免后，才将版本移至 _done/。
5. 如果存在版本级 execution-handoff.md，请根据 execution-handoff-generator 关闭其最终交付时间块并重新计算总流程秒数。

停止条件（仅限以下暂停原因）

条件	操作
子 Agent 报告某任务 blocked 且没有变通方案	停止；在切片交接记录和路线图中记录
Git 分支受保护 / 缺少工作分支	停止，直到存在有效的工作分支
真实环境阻塞项（Docker / 测试无法运行）	停止；在交接记录中注明
切片间依赖尚未满足	停止；修复路线图或前一个切片
缺少 {product_root} / {version_san} / 路线图	询问一次，然后继续
code-review-report.md 中存在未豁免的 P0 发现	停止，不得移至 _done/
需要人工豁免（应用菜单、移至 _done/）	仅针对该事项停止

禁止事项

• 不得在父级会话中实现应用代码 — 应委派给切片工作者。
• 成功完成切片后不得跳过提交（编排模式始终按切片提交）。
• 不得生成新的任务文件（运行时规划阶段已结束）。
• 不得访问仓库中的其他产品。
• 未经人工批准，不得应用导航语义分组。
• 实现编排期间不得运行后端 / 前端测试。

调用示例

Product: apps/my-product/
Version: 3.8.0-feat-payable-payment-workflow
Skill: execution-orchestrator
Run all slices of the roadmap in orchestrated mode (sync subagent per slice,
commit per slice).

Orchestrate the partitioned implementation of apps/my-product 3.8.0.

集成

阶段	技能
版本拆分 → 路线图 + 子版本	pm-version-partitioner
交接内容生成与更新	execution-handoff-generator
切片工作器（逐切片实现）	code-coder
版本结束审核关卡	code-reviewer
持续更新的规格整合	pm-living-spec-consolidator
工作分支 / GitLab 同步	mcp-gitlab-usage

参考资料

文件	阅读时机
references/slice-dispatch.md	精确的切片子 Agent 提示词模板和验证清单
../pm-version-partitioner/references/partition-workflow.md	生成你所使用路线图的规划循环