SuperAPI AI 工具集

multi-agent-orca

智能体与模型

查看项目

更新于 10-19 07:52

技能介绍

Multi-Agent Orca 是一个本地多智能体编排技能,把当前主会话当作 PM,围绕“拆解、派工、巡检、验收、收口”组织两个以上边界独立的 Worker。它的核心目标是让并行任务在独立分支或 worktree 中受监管地推进,并保证每个 Worker 的完成状态可被结构化核验,而不是靠终端输出或 UI 卡片猜测。资料强调:不要把“开了终端”误写成“建立了受监管任务”。

用途与适用边界方面,该技能用于同时推进两个以上边界独立、可分别验收的本地任务;需要独立 worktree、分支、session、额度 lane 或可人工接管的长任务;PM 需要读取 Worker 进度、纠偏、等待结构化完成事件并统一收口;以及用户明确要求 Orca、tmux、独立 session、多个 Worker、PM/orchestrator 或 Wave Autopilot 时。单个短任务、一次性问答、无并行价值的单文件修改,以及纯任务源、负责人和依赖状态同步,不在本技能范围内;branch/commit/push/PR/merge/冲突规则应使用 git-workflow。

主要能力包括:支持 Orca supervised、Orca terminal-managed、tmux worktree、tmux lightweight、同宿主 subagent 和远程节点(SSH 桥)等多种执行模式;提供 dispatch-value-gate、worker-value-postflight、review-acceptance-gate、acceptance-recovery 等门禁脚本;支持 Wave 准备屏障,先一次性写 manifest、创建一个 Run 并预建全部 Task,再并行启动;支持 ask/resume、Delivery FIFO 处理、ack 与幂等指纹;支持 429/usage limit 停滞恢复脚本 orca_rate_limit_recovery.py,默认只读,显式 --execute 才发送一次固定“继续”;支持内存预算排队(mem_budget_lane)与 worker node OOM 识别和退避;支持具名任务资源 profile 与验证负载纪律。

使用方式上,技能要求 PM 在任何 Worker 副作用前完成任务建模:读取项目规则和完整任务卡,确定目标、非目标、allowed/forbidden files、验证命令与完成条件;按根因、依赖链和文件范围分组,只有范围正交、验收独立、无共享锁文件/schema/迁移时才并行;为每个 Worker 指定 branch、branch_lifecycle、integration target/base、worktree、session、角色、backend/profile/model、provider slot 和资源 owner。随后按四道强制门禁执行:派发价值门、交付价值后门、角色分离验收门、失败恢复门,任一非零退出均不得跳过。新会话先读取 Orca 运行时合同(orca skills get orca-cli、orca skills get orchestration、orca status --json),再按 Wave 准备屏障创建 Run 与 Task,并通过 spawn-worker.sh 派发。

安全与限制方面,该技能会创建 Git/Orca worktree、分支、Session Context、终端、tmux session 以及 supervised Run/Task/Dispatch,但不自动安装依赖,也不自行扩张 push、merge、发布或外部调度授权。Orca worktree 创建固定使用 --setup skip;--base-ref 只接受引用名,不接受裸 sha;未知或不可证明的宿主失败关闭;Worker 只修改 allowed paths;tracked 文件删除是独立高风险类,需要精确路径写入不可变 allowed_write_paths。验证命令只接受一个权威来源,安装类命令需要精确 --allow-install-command 和可审计授权来源。pm-closeout.sh 默认清理一次性 Worker 的远端 head、worktree 与本地分支,长期功能/集成分支及固定 worktree 必须声明 long-lived 并保留。supervised 清理必须从 Session Context 取得精确 Run,并按 worker-list --run <run> --limit 100 完整遍历 opaque cursor 后唯一定位 Dispatch;前置分页、身份或结果不可证明时,在 release、terminal、worktree 和分支 mutation 前停止。

适用场景包括:多任务并行开发与验收、需要独立 worktree/分支隔离的长任务、需要 PM 统一总控和收口的多 Worker 协作、需要 429 停滞恢复和内存预算排队的资源管理场景、以及用户明确要求 Wave Autopilot 的场景。限制方面,资料未提供安装步骤、收费或价格信息、具体平台支持范围、效果评测数据,这些事实暂未提供;使用者应依据实际 Orca CLI 指南和 --help 输出操作,不应从本介绍推断未说明的功能或授权。