Orca Orchestration 是面向 Orca 多智能体运行时的编排技能。它适用于需要结构化多智能体协调的场景:线程化消息、阻塞式 ask/reply 流程、任务派发、等待 worker_done 或升级(escalation)、任务 DAG、决策闸门、协调器循环,以及把工作拆分给多个智能体。
用途与能力边界:需要监督、监控、等待结果或协调 DAG 时使用本技能;如果只是完整的归属权移交(如“hand off”“handoff”“handover”“give this to another agent”“another worktree”),且用户未要求监督、监控、等待结果或协调 DAG,则应改用 orca-cli 技能。普通的终端控制、shell 命令、worktree 管理和内置浏览器也属于 orca-cli 技能的范畴。协调依赖真实的 Orca 运行时状态,不能用非 Orca 的子智能体工具替代。
使用方式:首先确定本次会话使用的可执行文件,并在后续命令中保持一致。若设置了环境变量 ORCA_CLI_COMMAND,则使用其值(Orca 为受管 WSL 会话导出该变量);否则,在暴露 ORCA_DEV_REPO_ROOT 的开发检出中使用 orca-dev;否则,在 Orca 受管终端之外的 Linux 上使用 orca-ide——切勿在该环境直接运行裸 orca,因为在 Orca 终端之外它通常解析为 GNOME Orca 屏幕阅读器(/usr/bin/orca)并会在用户机器上启动语音;其余情况使用 orca。文中 ORCA 是占位符,执行前需替换为实际解析出的可执行文件,不要创建 shell 变量或直接运行 ORCA 字面量;POSIX shell、PowerShell 和 cmd.exe 中做法相同。若所选可执行文件无法运行,应报告其确切错误并停止,不要转而使用其他可执行文件,以免静默命中不同的 Orca 构建。
运行 Orca 命令前,先加载与版本匹配的指南:ORCA skills get orchestration。该命令由将处理后续命令的同一二进制输出紧凑的、版本匹配的指南,覆盖常规本地协调器循环。对于条件性动作闸门(如远程放置、不确定的发布恢复或扩展 DAG 工作),只加载该闸门指定的参考:ORCA skills get orchestration --reference references/<file>.md(用 --references 列出声明的名称)。若该二进制拒绝 --reference,则运行 ORCA skills get orchestration --full 并阅读其中命名的捆绑参考后再操作。
建议优先使用 --json。指南未覆盖的命令或标志可查看所选可执行文件的 --help。若命令报告 Orca 未运行,可用 ORCA open --json 启动后重试。若失败并返回 runtime_access_denied,说明沙箱阻止了连接:应以提升的权限重新运行,且不要运行 ORCA open 或重启 Orca。若 skills get 未知,应说明更新 Orca 可恢复该指南;可用 --help 做只读发现,不要猜测不支持的命令。
限制与缺失信息:本文件为发现入口,不包含完整用法指南,具体内容需由 orca 二进制提供;关于适用平台、安装方式、收费与价格等事实,当前资料暂未提供。