SuperAPI AI 工具集

orchestrate-batch-refactor

编程与开发

查看项目

更新于 10-16 05:43

技能介绍

用途:在跨多个文件或子系统的大规模重构中,通过依赖感知的工作包与并行分析来规划并执行重构,提升吞吐量并降低风险。

主要能力:并行分析目标范围;合成单一工作计划;将工作拆分为带明确文件归属与验证命令的工作包;按依赖层级排序,仅并行执行互相独立的工作包;用 worker 代理执行,并做集成与验证。

使用方式:先定义范围与成功标准(列出目标路径/模块、非目标、行为约束,如保持外部行为);再把范围拆分为若干分析通道,派生 explorer 子代理并行分析,每个代理输出意图图、耦合风险、候选工作包和所需验证;随后合并为一张依赖感知的工作图,按依赖层级排序工作包;每个独立工作包派生一个 worker 代理,分配明确的文件/职责归属,并告知其并非独自在代码库中工作、需忽略无关改动;最后审核输出、解决重叠、运行验证门禁,先做包级快速检查,再做跨包集成检查,范围广时再跑完整项目安全检查;最终总结各包结果、关键重构、解决的冲突与残余风险。

工作包规则:每个执行波次中每个文件只有一个归属者;重叠文件集不得并行编辑;目标保持窄且可衡量;包含明确的完成标准和必需检查;除非用户明确要求改变行为,否则优先采用保持行为的重构。计划契约要求每个工作包包含:包 ID 与目标、归属文件、依赖(无或包 ID)、需保持的风险与不变量、必需检查、面向主线程的集成说明,具体形状见 references/work-packet-template.md。代理提示契约使用 references/agent-prompt-templates.md 中的模板,explorer 提示侧重分析与分解,worker 提示侧重实施与验证并严格限定归属边界。

安全护栏:计划合成完成前不得启动 worker 执行;不得跨未解决的依赖并行;任何必需包检查失败时不得声称完成;若包边界导致反复合并冲突,应停止并重新规划。

限制:仅在任务明显匹配上述范围时使用;输出不能替代特定环境的验证、测试或专家评审;若缺少必要输入、权限、安全边界或成功标准,应停止并请求澄清。