大规模重构/重写时如何用并行多智能体安全高效地拆分与执行

当需要重构或重写大量文件、多个子系统时，用并行分析加依赖感知的工作包来协调子智能体完成。

适用场景

解决思路

1. 明确范围与成功标准：列出目标路径/模块与非目标，并声明行为约束（例如保持外部行为不变）。
2. 先并行分析：把目标范围拆成若干分析通道（lane），并行启动 explorer 子智能体分别分析每个通道；要求每个智能体产出意图图、耦合风险、候选工作包和所需验证项。
3. 构建单一依赖感知计划：把 explorer 的输出合并成一张工作图，创建带明确文件归属和验证命令的工作包，按依赖层级排序，只并行执行相互独立的工作包。
4. 用 worker 智能体执行：为每个独立工作包启动一个 worker，分配明确归属（文件/职责），并告知每个 worker 它并非独自在代码库中工作，必须忽略无关的改动。
5. 集成与验证：审查各工作包产出，解决重叠冲突，运行验证关卡；先跑每个工作包的定向测试，再对集成范围跑更广的测试套件。
6. 报告与收尾：总结各工作包结果、关键重构、已解决的冲突和残余风险。
7. 工作包规则：每个执行波次中每个文件只有一个负责人；不得对重叠文件集并行编辑；工作包目标要窄且可度量；包含明确的完成标准和必需检查；除非用户明确要求改变行为，否则优先做保持行为的重构。
8. 规划契约：每个工作包必须包含——1) 工作包 ID 与目标；2) 拥有的文件；3) 依赖（无或依赖的工作包 ID）；4) 风险与需保持的不变量；5) 必需检查；6) 给主线程的集成说明。使用 references/work-packet-template.md 获取确切格式。
9. 智能体提示契约：使用 references/agent-prompt-templates.md 中的提示模板；explorer 提示聚焦分析与分解，worker 提示聚焦实现与验证，并严格限定归属边界。
10. 安全护栏：在计划综合完成前不得启动 worker 执行；不得跨未解决的依赖并行；任何必需的工作包检查失败都不得声称完成；当工作包边界导致反复合并冲突时，停止并重新规划。
11. 验证策略按此顺序执行：1) 工作包级检查（快速且范围小）；2) 跨工作包集成检查；3) 范围广时跑全项目安全检查。优先快速反馈循环，但绝不跳过必需的行为检查。

适用边界 · 注意事项

• 范围很小或只涉及单个高度耦合文件的小改动，不值得多智能体执行。
• 依赖关系尚未理清时，不应并行执行。
• 任何必需的工作包检查失败时，不应声称完成。