utility-pm-workflow-orchestrator

PM 工作流编排器（Dispatch Skill）

pm-workflow-orchestrator 子 Agent 的跨客户端分发封装。检测运行环境；在 Claude Code 上分发给原生子 Agent；在非 Claude 客户端上读取 agents/pm-workflow-orchestrator.md，并通过“引用 + 内联执行”模式内联运行流程。编排器会按顺序运行来自已保存的优先级行动计划（模式 A）或用户命名链（模式 B）中的 pm-skills，默认暂停以等待继续或停止的指示，并在某个步骤失败或结果为空时停止。

状态摘要（更新于 v2.26.0）： 已在 Claude Code 原生路径上通过冒烟测试；在其他环境中为实验性功能。

• Claude Code（原生）：模式 B 链冒烟测试通过（2026-06-10，已安装插件）。 实际运行确认引擎通过 Skill 工具调用后续技能，并且这些技能会在引擎的上下文中内联执行（Skill 工具会将目标 SKILL.md 注入调用方的上下文；不会启动子 Agent），同时生成了实际产物，并遵守检查点暂停。尚未测试模式 A 原生运行，也尚未测试单个连续交互式引擎实例跨多个检查点运行；详情和注意事项见兼容性矩阵中的 v2.26.0 冒烟测试门禁记录。
• 所有非 Claude 客户端（Codex CLI、Cursor、Windsurf、Copilot CLI、Gemini CLI）： 在专门的维护者门禁测试实际运行多产物内联写入流程之前，均为实验性功能。编排器最多会写入三个完整的 PM 产物，并可能传递状态；这比协调器的内联路径严格得多，而且从未在 Claude Code 之外进行过实际验证。

对于任何客户端，请先运行 --dry-run 作为就绪性检查（它会测试解析、检查点、失败即停止以及工具能力预检，而不会调用会产生实际影响的技能）。请参阅子 Agent 兼容性矩阵，了解权威的安全使用矩阵。

适用场景

• 已生成 foundation-prioritized-action-plan，并希望按顺序运行其第 7 节中可运行的提示词，每一步都暂停以等待继续或停止的指示（模式 A）。
• 希望针对共享上下文运行临时的、由用户命名的 pm-skills 链（模式 B），例如先运行 deliver-prd，再运行 deliver-user-stories。在 Claude Code 上，/chain 命令是该模式的简洁入口。
• 希望获得一个通用运行器，用于运行动态链，而非预先整理好的 workflow-* 命令。

运行模式（与客户端无关）：

• CHECKPOINTED（默认）： 每个成功步骤完成后暂停，以便批准／编辑／跳过／重做。
• GUARDED AUTO（--auto，选择启用）： 对顺利完成的步骤不暂停；遇到失败仍会停止，结果为空时会暂停；对于 Complex／Chaotic 计划仍采用检查点模式，除非使用 --force-auto。

--thread 用于声明线性依赖关系，使每个步骤都能接收上一步已确认的产物；请参阅 references/PARSE-CONTRACT.md 中的模式 B 链表达式规范。

不适用场景

• 希望运行由作者手动维护的固定、精选、命名链（例如完整的 Foundation Sprint 或 Customer Discovery）-> 使用现有的 workflow-* 命令（workflow-foundation-sprint、workflow-customer-discovery 等）。编排器不会取代这些命令，并会将工作流步骤显示为 MANUAL，而不会嵌套执行。
• 只需要生成优先级行动计划（而非运行该计划）-> 使用 foundation-prioritized-action-plan（之后可以选择将计划交由本编排器运行）。
• 只需要评审一个产物 -> 使用 utility-pm-critic。
• 希望将库维护机制作为 PM 工作运行 -> 编排器会拒绝 Tier-3 维护技能。
• 希望编写可复用工作流，而非立即运行某条链 -> 使用 utility-pm-workflow-builder。该技能会生成持久化的命名工作流；本技能则运行临时链，不会保存定义。

说明

运行时检测步骤。 确定正在调用此技能的 AI 客户端。运行模式（检查点模式或自动模式）由用户的标志决定，与客户端无关。

如果你在安装了 pm-skills 插件的 Claude Code 中运行

使用用户输入以及 $ARGUMENTS 中的任何标志（--auto、--force-auto、--dry-run）调用 @agent-pm-skills:pm-workflow-orchestrator。原生子 Agent 会解析输入、构建步骤列表，并通过 Skill 工具将每个步骤委派给实际的下游技能，同时运行自己的逐步循环，并在需要确认时暂停。将引擎的逐步输出块和终端输出传达给用户。

此路径在 v2.24.0 中仍为实验性功能（参见状态摘要）。请指示用户先运行 --dry-run。

如果你在任何其他 AI 客户端中运行

Codex CLI、Cursor、Windsurf、Copilot CLI、Gemini CLI，或任何不支持原生 pm-skills 插件子 Agent 的客户端：

1. 工具能力预检（第一个操作，必须在解析或执行步骤 1 之前进行）。 验证客户端能否（a）在 _pm-skills/plan-orchestrator/<run>/ 下写入文件，以及（b）运行下游技能所需的任何 Bash 命令。
   • 如果无法写入文件：对于较短的运行，明确降级为纯聊天模式（警告用户，多步骤可靠性会降低，且由于完整工件必须保留在上下文窗口中，上下文预算会增加）；对于较长的运行，明确说明原因并拒绝运行。不要在运行中途失败。
   • 如果某个步骤需要 Bash，但客户端无法使用 Bash：在该步骤的边界处将其标记为受阻。
   • 记录检测到的能力；这些能力决定下面的磁盘写入行为。
2. 读取规范子 Agent 定义 agents/pm-workflow-orchestrator.md。
3. 读取共享解析和步骤状态约定 references/PARSE-CONTRACT.md（引擎也会读取同一文件；这可以避免内联分支与引擎出现偏差）。
4. 将引擎主体作为操作说明执行：进行运行前的拒绝检查，构建有序步骤列表（模式 A 解析或模式 B 命名链），然后逐步执行循环。
5. 在每个步骤中，读取下游技能的 SKILL.md，并在当前窗口中内联执行其方法；依据 references/PARSE-CONTRACT.md 中的标准，将返回结果归类为 PRODUCED / EMPTY / FAILED；启用磁盘写入时，将 NN-<skill-name>.md 写入运行目录。
6. 遵循运行模式：在 CHECKPOINTED 模式下，每个 OK 步骤后暂停；在 GUARDED AUTO 模式下，仅对明确判定为 PRODUCED 的步骤自动继续；FAILED 步骤会停止运行；EMPTY 或结果不明确时，始终暂停以请求确认（这是一个用户可以解除的强制检查点暂停），无论是否使用 --force-auto。
7. 按照引擎第 4.5 节的要求输出最终结果（运行完成或已停止）。

“引用并内联执行”模式支持跨客户端兼容性。在维护者门控的 WRITE 测试工具通过验证、能在每个客户端上完成真实的多工件运行之前，此模式仍为实验性功能。

--dry-run（就绪探测；在任何客户端上都应首先运行）

--dry-run 会遍历完整步骤列表，并测试解析、检查点、失败即停止以及工具能力预检，但不会调用任何会产生实际影响的下游技能。每个步骤都会输出“NOT EXECUTED - dry run”，并说明实际运行时会执行什么（使用哪个技能、采用哪种模式、是否会启用磁盘写入）。在投入 token 进行实际委派之前，使用此模式确认计划可以解析、链路能够解析完成，且客户端具备实时运行所需的工具访问权限。

跨客户端说明

由于非 Claude 客户端会在同一个上下文窗口中运行整个循环和每个步骤：

1. 上下文预算。 在多步骤运行中，合计预算（引擎正文 + 每个步骤后续读取的技能内容 + 生成的产物）可能接近上下文限制。引擎会在运行 2 个或更多步骤时自动启用磁盘写入，并在上下文中只保留每个已完成步骤的一行摘要；仅聊天模式无法获得这一缓解措施，因此长链任务优先使用具有写入能力的客户端。
2. 工具授权。 内联执行必须具备文件写入和 Bash 访问权限（而非只读）。上述预检（步骤 1）会检查这一点。Codex 可能需要启用其沙箱写入标志；Cursor 和 Gemini 可能会在每个步骤中插入审批关卡。
3. 不支持原生链式调用。 因此，引擎会通过 Skill（Claude Code）或内联读取并执行（非 Claude）来委派任务，绝不会生成子 Agent。若 Mode A 步骤解析为会分派给子 Agent 的技能（仅 utility-pm-critic），则会通过内联执行叶节点 Agent 来处理，绝不进行链式调用（引擎第 7.2 节）。

参考文件

• 规范的子 Agent 定义：agents/pm-workflow-orchestrator.md
• 共用的解析和步骤状态约定：references/PARSE-CONTRACT.md
• 输出模板：references/TEMPLATE.md
• 完整示例：references/EXAMPLE.md
• 产出方（在 HANDOFF 模式下将计划交至此处）：skills/foundation-prioritized-action-plan/SKILL.md
• 子 Agent 兼容性矩阵：docs/reference/sub-agent-compatibility.md
• 运行时组件目录：docs/reference/runtime-components.md
• 库示例（单个检查点运行）：library/sub-agent-samples/pm-workflow-orchestrator/