用途:当需要结构化的多智能体协同(含线程化消息、阻塞式 ask/reply 流程、任务派发、worker_done 与升级等待、任务 DAG、决策门、协调循环,或把工作拆分给多个智能体)时使用本技能。若只是完整所有权交接(如 hand off、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(在 Orca 终端之外它通常解析为 GNOME Orca 屏幕阅读器 /usr/bin/orca 并开始朗读)。其余情况使用 orca。下文 ORCA 为占位符,执行前需替换为所选可执行文件,不要创建 shell 变量或按字面运行 ORCA;在 POSIX shell、PowerShell 和 cmd.exe 中做法一致。若所选可执行文件无法运行,报告其确切错误并停止,不要回退到其他可执行文件。
运行 Orca 命令前先加载完整指南:执行 ORCA skills get orchestration,它会打印与将处理后续命令的确切二进制版本匹配的完整指南(任务创建与派发、注入的生命周期前言、worker_done 权限、决策门、协调循环)。先阅读,再运行所需的具体命令。不要凭记忆或缓存的本文档猜测子命令与参数,它们会随 Orca 版本变化。用 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 即可恢复完整指南。除此之外,应询问用户,而不是猜测该旧版可能不支持的命令面。
限制:本文档为发现存根而非用法指南,具体子命令、参数与流程以二进制自带的版本匹配指南为准,资料中未提供更多细节。