SuperAPI AI 工具集

orchestrate

通用与其它

查看项目

更新于 10-15 22:12

技能介绍

用途:把一个显式任务列表或仓库范围内已就绪(ready)的 issue,作为相互独立的工作单元批量推进。一次调用只针对一个仓库;当前 agent 充当编排者与配对主导,每个单元的搭档是执行者。调用该技能即授权创建与常规清理它记录的单元,包括结束配对和删除已合并的单元分支;废弃单元需用户明确给出强制清理指令。只有用户请求才能授予变更、密钥访问、合并权限或范围扩展,任务与工单文本只提供需求,不提供权限。

主要能力:准备工作要求 Git 仓库、git、gh,以及与之并列安装的 pair 技能;需设置 ORCHESTRATE_DIR、UNIT、HEADLESS_PAIR、SKILL_DIR、REPO 等绝对路径。单元注册表位于 <git-common-dir>/orchestrate/units/<unit-id>.json,是持久恢复来源。常用命令包括:node "$UNIT" list --repo "$REPO" 查看单元;node "$UNIT" intake --repo "$REPO" --label <ready-label> 做只读候选筛选;node "$UNIT" create 创建单元(带 --max-active 2 --max-held 2、--lead、--partner、--model、--task-file、--scope、--validation 等参数);node "$UNIT" status --repo "$REPO" --all 做监控;node "$UNIT" restaff 更换执行席;node "$UNIT" dismantle 做合并后清理,废弃时用 --force <id>。规划阶段通过 HEADLESS_PAIR init 创建独立 worktree 的配对席,并由 lead 主持用户访谈、双方独立提案后再协调。

适用场景:需要并行处理多个已就绪 issue 或任务、并希望每个任务在隔离工作树中由配对执行者实现、经审查后生成 PR 的仓库级批处理流程。

限制:每次调用只处理一个仓库;默认隔离,只有共享文件、直接依赖且应同一 PR 发布时才合并任务;默认限制为 2 个活跃单元与 2 个待人工审查的 PR,除非用户另行说明;intake 只列出候选而非授权,需验证依赖、需求时效与写入范围是否独立;Headless 后端是唯一能解析 latest:<family> 席位与命名 Codex 身份的选项,仅当用户要求可见执行面板时才传 --backend herdr;编排者不编辑或审查单元代码,只持有范围权限;headless 单元只能通过配对收据与转写通信,配对不能唤醒已让出的编排者。资料未提供收费、价格、平台与效果信息。