Orca Orchestration 是一个用于多智能体协调的 Orca 技能。本文件只是发现用的存根,不是使用指南;与版本匹配的完整 Orca 编排参考由 orca 二进制程序自身提供,刻意不写在本文件中,以免与实际执行命令的二进制产生偏差。
用途
当你需要结构化的多智能体协调时使用 Orca 编排,包括:线程化消息、阻塞式 ask/reply 流程、任务派发、worker_done 与升级等待、任务 DAG、决策门、协调器循环,以及把工作拆分给多个智能体。若用户没有要求监督、监控、等待结果或协调 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,为将要处理后续命令的确切二进制打印完整且版本匹配的指南,涵盖任务创建与派发、注入的生命周期前导、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 后会通过 ORCA skills get orchestration 恢复完整且版本匹配的指南。除这些命令外,应询问用户,而不是猜测该旧版二进制可能不支持的命令面。
限制
资料未提供更具体的能力细节、收费方式、平台要求或使用步骤;完整命令、标志与流程需以对应二进制输出的指南为准。