用途
Coliseum Dispatch 是 Coliseum 流程中的派发阶段技能,负责将一组已组合好的任务信封(assignment envelopes)并行发送给领域专家子代理。其核心目标是实现“力量倍增”(force-multiplication),即通过单条消息中的多个 Agent 工具调用同时启动所有子代理,而非顺序派发。
主要能力
- 并行派发:在单条消息中为每个信封发起一个 Agent 工具调用,所有子代理大致同时启动。
- 无乒乓门禁(no-pingpong gate):派发前调用 pingpong-detector 代理检查信封,避免派发容易产生来回乒乓的信封。
- 逐信封预检:确认推荐子代理类型存在、返回文件路径的父目录存在。
- 派发日志:派发后立即写入 phase-3-dispatch-log.md,记录派发摘要、派发表、预期返回、替换说明等。
- 返回追踪:等待或接收返回,更新日志中的返回清单。
- 交接对账:所有返回到位后,调用 coliseum-reconciliation 技能。
使用方式
- 运行无乒乓门禁:以 phase-2-assignments.md 为输入调用 pingpong-detector 代理,等待裁决。PASS 则继续;PARTIAL 需修复或经用户明确批准;FAIL 则返回 Phase 2 修复,不得派发。
- 逐信封预检:确认推荐子代理类型在运行时可用,若不存在则替换为最接近的类型并在日志中注明;确认返回文件路径的父目录存在,不存在则创建(工作目录下的 returns/)。
- 组合并行派发:在单条消息中,为每个信封发起一个 Agent 工具调用。每个调用包含 description、subagent_type、prompt(完整信封内容,自包含,包含交接块)。prompt 必须以明确指令结尾,要求将返回产物写入指定绝对路径,遇到无法解决的阻塞时写入 BLOCKED 块而非返回询问。
- 决定前台或后台:前台(默认)等待所有子代理完成;后台(run_in_background: true)适用于长时间运行且编排器有独立工作的情况。标准 grain-to-coliseum 流程使用前台。
- 写入派发日志:派发消息发出后立即写入 phase-3-dispatch-log.md,包含 grain 原文、派发摘要、派发表、预期返回、替换及理由。
- 追踪返回:等待返回(前台)或接收通知(后台),更新日志中的返回清单。若返回包含 BLOCKED 块,这是信号而非失败,由对账阶段处理。
- 交接对账:所有返回到位后,以工作目录为参数调用 coliseum-reconciliation 技能。
适用场景
适用于需要将一组独立任务并行分发给多个领域专家子代理的编排流程,特别是 Coliseum 流程中的派发阶段。要求信封之间无真实依赖关系,否则应在 Phase 2 降级为 Phase-4 后续任务。
限制
- 顺序派发是失败模式;唯一可接受的顺序派发原因是信封之间存在真实依赖,但若存在真实依赖,该信封应在 Phase 2 降级为 Phase-4 后续任务,而非在此派发。
- 无乒乓门禁不可跳过。
- 若信封内容中隐含了顺序(例如 assignment-002 的 prompt 引用了 assignment-001 的返回产物),则已将并行坍缩为串行,需在派发前重构。
- 参考材料:references/handoff-envelope-spec.md(派发 prompt 必须包含的内容)、references/parallel-dimensions.md(什么使维度真正并行)。