---

name: "orchestrate-batch-refactor" description: "规划并执行大规模重构，支持依赖感知的工作包和并行分析。" risk: safe source: "Dimillian/Skills (MIT)" date_added: "2026-03-25"

编排批量重构

概述

使用此技能安全地执行高吞吐量重构。 并行分析范围，合成统一计划，然后通过子代理执行独立的工作包。

适用场景

• 重构跨越多个文件或子系统，需要清晰的工作划分。
• 在并行实施之前需要依赖感知的规划。

输入

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

何时使用并行化

• 当范围为中/大型且涉及多个文件或子系统时使用此技能。
• 对于微小编辑或高度耦合的单文件工作，跳过多代理执行。

核心工作流

1. 定义范围和成功标准。
   • 列出目标路径/模块和非目标。
   • 声明行为约束（例如：保持外部行为不变）。
2. 首先运行并行分析。
   • 将目标范围拆分为分析通道。
   • 并行生成 explorer 子代理来分析每个通道。
   • 要求每个代理提供：意图映射、耦合风险、候选工作包、所需验证。
3. 构建一个依赖感知计划。
   • 将探索器输出合并为单一工作图。
   • 创建具有明确文件所有权和验证命令的工作包。
   • 按依赖层级排序工作包；仅并行运行独立的工作包。
4. 使用工作代理执行。
   • 为每个独立工作包生成一个 worker。
   • 分配明确的所有权（文件/职责）。
   • 告知每个工作代理它们不是代码库中唯一的操作者，必须忽略无关的编辑。
5. 集成和验证。
   • 审查工作包输出，解决重叠，运行验证门控。
   • 对每个工作包运行针对性测试，然后对集成范围运行更广泛的测试套件。
6. 报告和收尾。
   • 总结工作包结果、关键重构、已解决的冲突和残余风险。

工作包规则

• 每个执行波次中每个文件只有一个所有者。
• 不对重叠的文件集进行并行编辑。
• 保持工作包目标狭窄且可衡量。
• 包含明确的完成标准和必需检查。
• 优先选择保持行为不变的重构，除非用户明确要求行为变更。

规划契约

每个工作包必须包含：

1. 工作包 ID 和目标。
2. 所属文件。
3. 依赖关系（无或工作包 ID）。
4. 风险和需要保持的不变量。
5. 必需检查。
6. 主线程的集成说明。

使用 references/work-packet-template.md 获取确切格式。

代理提示契约

• 使用 references/agent-prompt-templates.md 中的提示模板。
• 探索器提示专注于分析和分解。
• 工作器提示专注于实施和验证，具有严格的所有权边界。

安全护栏

• 在计划合成完成之前不要开始工作器执行。
• 不要跨未解决的依赖关系进行并行化。
• 如果任何必需的工作包检查失败，不要声称完成。
• 当工作包边界导致反复合并冲突时，停止并重新规划。

验证策略

按以下顺序运行：

1. 工作包级别检查（快速且有范围限定）。
2. 跨工作包集成检查。
3. 当范围较广时运行完整项目安全检查。

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

局限性

• 仅在任务明确匹配上述范围时使用此技能。
• 不要将输出视为环境特定验证、测试或专家审查的替代品。
• 如果缺少必需的输入、权限、安全边界或成功标准，停止并请求澄清。