SuperAPI AI 工具集

batch

通用与其它

查看项目

更新于 10-16 08:39

技能介绍

用途:把跨代码库的大规模改动拆解为独立单元并行执行。每个单元在隔离的 git worktree 中由独立智能体实现、测试并创建 PR。

前置条件:处于 git 仓库内、工作树干净、配置了用于创建 PR 的 remote,且可用 gh CLI。校验命令:git rev-parse --is-inside-work-tree、git status --porcelain、git remote -v、which gh;任一不满足则停止并报告缺失项。

触发方式:/batch <大规模改动描述>,或用户要求 batch、跨代码库修改、apply everywhere。输入为必填的改动描述。

流程:Phase 1 用 Grep/Glob 研究代码库,识别受影响文件、既有模式、共享依赖与冲突;Phase 2 拆成 5-30 个独立、自包含、可测试、尽量 1-5 文件的小单元,禁止两单元修改同一文件,共享依赖先做(作为 Unit 1),按模块分组;Phase 3 展示拆解计划并等待用户明确批准,未批准不得执行;Phase 4 先跑顺序单元,再并行派发后台智能体,每个智能体在 /tmp 下新建 worktree 与 batch/ 分支,仅改指定文件,运行测试命令,通过后提交推送并用 gh pr create 建 PR,失败两次则以 [WIP] 前缀提交并记录;结束后强制移除 worktree。Phase 5 汇总滚动状态表;Phase 6 给出最终完成统计、PR 列表、失败单元与后续步骤。

边界情况:少于 5 个单元照常执行;超过 30 个需合并以降至 30 以下;发现共享文件冲突则合并单元;worktree 创建失败则退化为直接分支并记录;无测试则照常实现并标注;用户拒绝计划则询问调整并重新拆解;无 remote 或 gh CLI 缺失时跳过 PR,仅推送分支并报告。

约束:本技能只做编排,不直接实现改动;单元智能体派发后完全自主;单元间不得有共享可变状态;必须等待用户批准计划;失败单元不阻塞成功单元;所有 worktree 必须清理(含失败场景)。

适用场景:代码库级迁移、跨模块统一模式(日志、错误处理、追踪)、批量重构、添加横切关注点(校验、鉴权)。可与 /simplify、测试缺口分析器、PR 审查助手配合。以上内容均来自公开技能资料。