SuperAPI AI 工具集

arc-parallel-implement

智能体与模型

查看项目

更新于 10-16 09:53

技能介绍

用途:并行实现多个相互独立、已有计划的用户故事(issue 或 W-XXXXXX)。前置条件是每个故事都有计划、验收标准、目标文件与验证命令;若缺计划先用 arc-planning-work。依赖强或文件高度重叠的故事应串行,单故事用 arc-work-issue。

主要能力:工作树优先。每个故事创建独立分支与隔离 worktree(默认 feat/W-XXXXXX-<short-description>,路径 .arc/worktrees/<story-slug>),父会话保留规划、路由选择、验收、评审判断与批准,子代理只在指定 worktree 内编辑和验证。支持交付模式:--ship pr(默认,每个被接受故事开一个 PR 等待评审)、--ship auto(仅在调用方明确要求时启用自动合并)、--ship merge(仅在明确要求时合并)。

使用方式:先做运行时能力预检,按能力而非产品名选择运行时。原生 Arc Pi 路径要求 subagent_spawn 与 subagent_wait 同时可用,subagent_list、subagent_check、subagent_cancel 为辅助;subagent_spawn 非阻塞,记录返回的 arc-sub-... ID,单个父会话最多四个活跃子代理,超出按每波最多四个分批,波间用 subagent_wait 等待认领结果。原生子代理仅有内置编码工具,不能嵌套子代理、ARC 委派、后台终端、决策/提问工具、扩展或外部模型工作器,其本地 bash 属可信主机执行而非 OS 沙箱。原生对不可用时才用非 Pi 外部编排器回退,需其暴露可用的有界并行派发与结果收集能力;两者都不可用则停止并报告缺失能力,不得创建 worktree 或 .arc/ 目录。

流程要点:预检通过后,用 gh issue view <number> --json title,body,labels 与 gh issue view <number> --comments --json comments 收集信息并建立文件映射;创建隔离 worktree;按契约派发有界故事工作(含禁止提交、推送、评论、合并、部署、改密、更新 issue 等约束);父会话逐故事对比计划与验收标准审阅 diff 并跑聚焦测试,worker 输出是证据而非结论;仅由父会话执行提交与交付,只暂存故事范围内的允许清单,禁止 git add .;每个被接受故事保持一个故事、分支、提交与 PR,被阻塞故事不交付。最后按分支、issue、测试、文件、PR/状态逐行报告;仅在 PR 合并后删除 worktree,--ship pr 与 --ship auto 下保留 worktree 与分支并报告路径。

限制:原生子代理有数量上限且父会话关闭会取消活跃子代理,不能当作持久任务;cwd 必须为当前项目内已存在的相对目录,不得用绝对路径或 ../ 越界,也不得指向其他故事的路径;命名如 codex-*、opus-review、composer-implement 等并非原生路由,不得当作 subagent_spawn 的 model 值。资料未提供收费、价格与具体计费信息。