Orca Orchestration
用途
Orca Orchestration 用于结构化的多智能体协调场景。当需要在线程化消息、阻塞式 ask/reply 流程、任务派发、worker_done 或 escalation 等待、任务 DAG、决策门、协调者循环，以及把工作拆分到多个智能体之间时，可以启用该技能。它依赖真实的 Orca 运行时状态，不能用非 Orca 的子智能体工具替代以实现协调。
何时改用它
如果用户没有要求监督、监控、等待结果或协调 DAG，而是需要完全的所有权交接，例如“hand off”“handoff”“handover”“give this to another agent”“another worktree”，应改用 orca-cli 技能。普通的终端控制、shell 命令、worktree 管理以及内置浏览器也应当使用 orca-cli 技能。
说明文件的性质
本文件是一个发现用存根，并非使用指南。完整的、与版本匹配的 Orca 编排参考由 orca 二进制文件自身提供，故意不放在本文件中，以避免其与真正运行命令的二进制发生偏差。
解析本次会话的 CLI
需要一次性选择可执行文件，并在后续所有命令中复用：
- 如果设置了环境变量 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 运行时状态。关于收费、价格、平台支持、效果等具体信息，资料中暂未提供。