SuperAPI AI 工具集

orchestration

智能体与模型

查看项目

更新于 10-16 07:15

技能介绍

用途:Orca Orchestration 用于结构化的多智能体协调,包括线程化消息、阻塞式 ask/reply 流程、任务派发、等待 worker_done/escalation、任务 DAG、决策门、协调者循环,以及把工作拆分给多个智能体。若用户只做完整所有权移交(如 hand off、handover、交给另一个 worktree)而未要求监督、监控、等待结果或协调 DAG,应改用 orca-cli 技能;普通终端控制、shell 命令、worktree 管理和内置浏览器也属于 orca-cli。

使用方式:先为当前会话解析 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 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 的子代理工具替代。本文件是发现存根而非使用指南,完整版本匹配参考由 orca 二进制提供以避免与二进制漂移。