用途:Orca 的结构化协调层,管理智能体消息、任务归属、派发状态与 worker 完成跟踪。当协调状态重要时使用;轻量终端提示或基础 worktree/终端/内置浏览器控制请用 orca-cli。
主要能力:智能体终端间 send/reply/ask 持久消息;向 worker 派发结构化任务并等待 worker_done 或 escalation;跟踪带依赖的任务 DAG;运行协调循环与决策门。消息类型含 status、dispatch、worker_done、merge_ready、escalation、handoff、decision_gate、heartbeat;组地址含 @all、@idle、@claude、@codex、@opencode、@gemini、@droid、@worktree:<id>。
前置条件:orca status --json 显示运行时在运行;orca 在 PATH 中(Linux 为 orca-ide);在 Settings > Experimental 启用 orchestration 实验特性。命令是对运行中 Orca 运行时的 RPC 调用。
用法要点:任务状态为 pending、ready、dispatched、completed、failed、blocked。--inject 会把任务规格与前言注入可识别 agent CLI 以便上报 worker_done;裸 shell 则省略 --inject,用 orca terminal send 手动发提示。监督 worker 时用 check --wait --types worker_done,escalation,decision_gate --timeout-ms <n> 代替 sleep/轮询;check --wait 每次返回一条消息,N 个 worker 可能同时完成时需循环 N 次。worker 需阻塞答案时用 ask,它创建 decision_gate 消息由协调者 reply 回答。gate-create 仅用于协调者管理的任务 DAG 决策。同一任务连续失败 3 次会触发派发上下文熔断并标记 failed。reset 仅用于恢复,会清除运行时全局协调状态。
适用场景:多 worker 并行实现、任务依赖编排、协调者循环与决策门。建议优先使用跨 worktree worker;同一 worktree 分屏仅用于不会编辑相同文件的互补任务。依赖链避免超过 3-4 步。
限制:派发前需等待 tui-idle,并始终传 --timeout-ms,真实编码任务可能耗时 15-60 分钟。若 check --wait 超时且无 worker_done 或 escalation,回退到 terminal wait --for tui-idle 再 terminal read。通过终端历史或完整交接继承的前言视为过期,除非当前提示明确保留该协调者。未提供收费、价格与平台信息。