用途：在需要结构化多智能体协调时启用 Orca orchestration，包括线程化消息、阻塞式 ask/reply 流程、任务派发、worker_done/升级等待、任务 DAG、决策门、协调循环，以及把工作拆分给多个智能体。若只是完整所有权交接（handoff、handover、把任务交给另一个智能体或另一个 worktree），且用户未要求监督、监控、等待结果或协调 DAG，应改用 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，因为它通常解析为 GNOME Orca 屏幕阅读器（/usr/bin/orca）并触发语音。其余情况使用 orca。下文 ORCA 为占位符，运行前需替换，不要创建 shell 变量或直接运行 ORCA。若所选可执行文件无法运行，报告其确切错误并停止，不要回退到其他可执行文件。
运行 Orca 命令前先加载完整指南：ORCA skills get orchestration。它会输出与将处理后续命令的确切二进制版本匹配的完整指南，涵盖任务创建与派发、注入的生命周期前言、worker_done 权限、决策门和协调循环。先阅读，再运行具体命令。不要凭记忆或缓存副本猜测子命令与标志。用 ORCA status --json 确认应用已启动（必要时用 ORCA open --json 启动），面向智能体的调用优先使用 --json。
若旧版 Orca 不识别 skills get：仅当所选二进制明确报告 skills get 是未知命令时才使用回退。其他失败不能证明是旧版二进制，应报告而非猜测或更换可执行文件。对确认的旧版二进制，仅使用以下有界只读引导：ORCA status --json、ORCA orchestration task-list --json、ORCA terminal list --json。然后告知用户更新 Orca 即可通过 ORCA skills get orchestration 恢复完整版本匹配指南。除此之外，应询问用户，而不是猜测该旧版可能不支持的命令面。
限制：本文件是发现存根而非使用指南，完整参考由 orca 二进制提供，以避免与将实际运行命令的二进制产生偏差。具体子命令、标志与版本行为以二进制输出为准，资料未提供更细的接口清单。