ns-execution-orchestrator

执行编排器

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

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

探索 Harness

请参阅 ../ns-harness/references/harness-discovery.md 和 ../ns-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}/** 以及 Harness 基础设施（AGENTS.md、{harness}/）下操作。绝不读取或引用 monorepo 中的其他产品。如果 Harness 中存在范围隔离规则，请参阅该规则。

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

1. 阅读 AGENTS.md（实现部分），并加载 Harness 执行规则。
2. 阅读 {product_root}/docs/versions/{version_san}/version-roadmap.md — 必须执行。如果文件缺失，则停止：此版本未分区；应直接执行其任务，而不是使用编排方式。
3. 阅读主文件 {product_root}/docs/versions/{version_san}/requirements.md （仅供概览 — 不要重新规划）。
4. 如果 Harness 中存在 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（阻塞式／同步，不在后台运行）： 必须在可用时使用执行框架 coder-agent（参见 ../ns-harness/references/subagent-dispatch.md）；否则使用提示词遵循 ns-code-coder 的通用子 Agent。提示词仅包含：
   • {product_root}、{version_san}、{subversion_san}
   • 指示其遵循 ns-code-coder 技能，作为由执行编排器调用的切片工作器（使用 coder-agent 时，桥接已指向该技能）
   • 路径仅限于 {product_root}/docs/versions/{version_san}/subversions/{subversion_san}/ 中的切片任务；编码前还要根据 artifact-layout.md 的实现启动规则加载 {product_root}/docs/context/ （以及执行框架要求的层级规则）
   • 要求：实现切片的所有任务，任务之间无需确认，不提交（由父级提交）
   • 明确说明：切片执行期间不要运行测试；只进行实现
   • 强调（简短）：严格遵守 AGENTS.md 和执行框架规则；若任何指令与规则或范围冲突，停止并报告阻碍，不得自行假设并继续
4. 验证子 Agent 的结果（仅单元／集成测试——切片执行期间绝不运行 E2E；由人类在版本结束时运行 E2E）：
   • 切片的每项任务都标记为 completed 或 waived（豁免情况须在交接文档中注明）
   • 根据 ns-sdd-execution-handoff-generator 更新切片交接文档（时间块 + 任务行）
   • 工作器已更新路线图行（否则由你更新）
5. 提交（仅父级）：每个切片提交一个 Conventional Commit。
6. 标记路线图行 → completed（如果工作器尚未标记）。
7. 自动推进到下一个切片。

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

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

1. 展示任何导航／语义分组菜单，并在应用前等待人类批准。
2. 运行实现后审查：在可用时必须派发 reviewer-agent（否则使用只读的 ns-code-reviewer）审查版本差异。不要期待有 code-review-report.md——被拒绝时使用判定行和最简修复映射。参见 ../ns-harness/references/subagent-dispatch.md。
3. 审查结果为 Approved 后，整合常驻规范——ns-sdd-living-spec-consolidator。
4. 仅当人类确认或存在有记录的豁免时，才将版本移至 _done/。
5. 如果存在版本级 execution-handoff.md，则关闭其最终交付块，并根据 ns-sdd-execution-handoff-generator 重新计算总流程秒数。

停止条件（仅以下情况需要暂停）

条件	操作
子 Agent 报告某项任务 blocked 且无解决方法	停止；在切片交接文档和路线图中记录
Git 受保护分支／缺少工作分支	停止，直到存在有效的工作分支
实际环境阻碍（Docker／测试无法运行）	停止；在交接文档中注明
切片间依赖未满足	停止；修复路线图或前序切片
缺少 {product_root}／{version_san}／路线图	询问一次，然后继续
Code Review: Rejected／Blocked 且无豁免	在移至 _done/ 前停止；应用修复映射
需要人类豁免（应用菜单、移至 _done/）	仅针对该事项停止

禁止事项

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

调用示例

Product: apps/my-product/
Version: 3.8.0-feat-payable-payment-workflow
Skill: ns-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.

集成

阶段	技能
版本分区 → 路线图 + 子版本	ns-sdd-version-partitioner
交接生成与更新	ns-sdd-execution-handoff-generator
切片工作者（逐切片实施）	coder-agent → ns-code-coder
版本结束审查关卡	reviewer-agent → ns-code-reviewer
整合持续维护的规范	ns-sdd-living-spec-consolidator
工作分支／GitLab 同步	mcp-gitlab-usage

参考资料

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