orchestrate-batch-refactor

编排批量重构

概述

使用此技能安全地执行高吞吐量重构。 并行分析范围，整合出一份统一计划，然后使用子 Agent 执行彼此独立的工作包。

输入

• 仓库路径和目标范围（路径、模块或功能区域）
• 目标类型：重构、重写或混合
• 约束：行为一致性、API 稳定性、截止时间、测试要求

何时使用并行化

• 对于涉及许多文件或子系统的中型或大型范围，请使用此技能。
• 对于微小修改或高度耦合的单文件工作，请跳过多 Agent 执行。

核心工作流

1. 定义范围和成功标准。
   • 列出目标路径／模块和非目标事项。
   • 说明行为约束（例如：保留外部行为）。
2. 先并行分析。
   • 将目标范围拆分为多个分析方向。
   • 并行启动 explorer 子 Agent，分别分析每个方向。
   • 要求每个 Agent 提供：意图映射、耦合风险、候选工作包、所需验证。
3. 制定一份考虑依赖关系的计划。
   • 将 explorer 的输出合并成一张工作图。
   • 创建工作包，明确文件归属和验证命令。
   • 按依赖级别安排工作包；仅并行执行彼此独立的工作包。
4. 使用 worker Agent 执行。
   • 为每个独立工作包启动一个 worker。
   • 明确指定归属范围（文件／职责）。
   • 告知每位 worker：代码库中还有其他 Agent，必须忽略无关修改。
5. 集成并验证。
   • 审查各工作包的输出，解决重叠，并运行验证关卡。
   • 先针对每个工作包运行定向测试，再对集成后的范围运行更广泛的测试套件。
6. 汇报并收尾。
   • 总结各工作包的结果、关键重构、已解决的冲突和残余风险。

工作包规则

• 每个执行波次中，每个文件只能有一个负责人。
• 不得并行修改有重叠的文件集。
• 工作包目标应范围明确且可衡量。
• 明确列出完成标准和所需检查。
• 除非用户明确要求改变行为，否则优先采用保留行为的重构。

计划约定

每个工作包必须包含：

1. 工作包 ID 和目标。
2. 负责的文件。
3. 依赖项（无依赖或工作包 ID）。
4. 风险和需保留的不变量。
5. 所需检查。
6. 提供给主线程的集成说明。

具体格式请参阅 references/work-packet-template.md。

Agent 提示词约定

• 使用 references/agent-prompt-templates.md 中的提示词模板。
• Explorer 提示词侧重分析和任务拆分。
• Worker 提示词侧重实现和验证，并严格遵守归属边界。

安全护栏

• 计划整合完成前，不得启动 worker 执行。
• 不得跨尚未解决的依赖关系并行执行。
• 任何必需的工作包检查失败时，不得声称已完成。
• 如果工作包边界反复引发合并冲突，应停止执行并重新规划。

验证策略

按以下顺序运行：

1. 工作包级检查（快速且范围明确）。
2. 跨工作包集成检查。
3. 范围较广时，运行完整的项目安全检查。

优先采用快速反馈循环，但绝不要跳过必需的行为检查。