SuperAPI AI 工具集

orchestration

智能体与模型

查看项目

更新于 10-16 07:19

技能介绍

用途:Orca 编排用于结构化多智能体协作。当需要线程化消息、阻塞式 ask/reply 流程、任务派发、等待 worker_done 或 escalation、任务 DAG、决策门、协调者循环,或把工作拆分给多个智能体时使用。若只是完整所有权交接(hand off、handoff、handover、把任务交给另一个智能体或另一个 worktree),且用户没有要求监督、监控、等待结果或协调 DAG,应改用 orca-cli skill;普通终端控制、shell 命令、worktree 管理与内置浏览器同样不属于本技能。协调依赖真实的 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 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 运行时状态;完整用法指南由 orca 二进制提供,本文件仅为发现入口,无法替代二进制版本匹配的参考。