SuperAPI AI 工具集

orchestrate-batch-refactor

编程与开发

查看项目

更新于 10-15 13:10

技能介绍

用途

Orchestrate Batch Refactor 用于安全地运行高吞吐量的重构工作。它先并行分析范围,再综合出单一计划,然后用子智能体执行相互独立的工作包。适用于用户要求重构大量文件或子系统、进行重写或混合型改造的场景。

主要能力

  • 并行分析:将目标范围拆分为分析通道,并行启动探索型子智能体,要求每个智能体输出意图图、耦合风险、候选工作包和所需验证。
  • 依赖感知计划:将探索结果合并为单一工作图,创建具有明确文件归属和验证命令的工作包,按依赖层级排序,仅并行运行相互独立的工作包。
  • 工作智能体执行:为每个独立工作包启动一个工作智能体,分配明确归属(文件/职责),并告知每个智能体代码库中并非只有它一个,必须忽略无关编辑。
  • 集成与验证:审查工作包输出,解决重叠,运行验证关卡;先运行每个工作包的目标测试,再对集成范围运行更广泛的测试套件。
  • 汇报与收尾:总结工作包结果、关键重构、已解决的冲突和残余风险。

使用方式

输入包括:仓库路径和目标范围(路径、模块或功能区域);目标类型(重构、重写或混合);约束条件(行为一致性、API 稳定性、截止时间、测试要求)。

核心工作流:

  1. 定义范围与成功标准:列出目标路径/模块和非目标,说明行为约束(例如保持外部行为)。
  2. 先运行并行分析:拆分分析通道,并行启动探索子智能体。
  3. 构建一个依赖感知计划:合并输出为单一工作图,创建带文件归属和验证命令的工作包,按依赖层级排序。
  4. 用工作智能体执行:每个独立工作包一个智能体,明确归属,强调忽略无关编辑。
  5. 集成与验证:审查输出、解决重叠、运行验证关卡。
  6. 汇报与收尾。

工作包规则:每一执行波次中每个文件只有一个负责人;不并行编辑重叠文件集;工作包目标保持狭窄且可衡量;包含明确的完成标准和必需检查;除非用户明确要求改变行为,否则优先保持行为的重构。

规划契约:每个工作包必须包含工作包 ID 和目标、拥有的文件、依赖(无或工作包 ID)、需保留的风险和不变量、必需检查、给主线程的集成说明。使用 references/work-packet-template.md 获取确切格式。

智能体提示契约:使用 references/agent-prompt-templates.md 中的提示模板。探索型提示聚焦分析与分解;工作型提示聚焦实现与验证,并带有严格的归属边界。

适用场景

适用于中大型范围、涉及许多文件或子系统的重构。对于微小编辑或高度耦合的单文件工作,应跳过多智能体执行。

限制与安全护栏

  • 在计划综合完成之前,不得开始工作智能体执行。
  • 不得在未解决的依赖之间并行化。
  • 如果任何必需的工作包检查失败,不得声称完成。
  • 当工作包边界导致反复合并冲突时,应停止并重新规划。

验证策略按以下顺序运行:工作包级检查(快速且范围明确)、跨工作包集成检查、范围广泛时的全项目安全检查。优先快速反馈循环,但绝不跳过必需的行为检查。