大规模重构的风险控制与回归

大规模重构是高级用户的试金石：范围大、跨模块、容易引入回归。本节讲如何把一次大重构控制在可预期、可回滚、可验证的范围内，让代理成为执行力，而你掌控节奏。

一、开工前先划定边界

重构最忌范围蔓延。下达任务时就写清楚：目标是什么、涉及哪些模块、明确列出哪些东西不许动（如对外接口、持久化格式、第三方依赖版本）。让代理先输出一份"改动计划 + 影响面分析"，你确认后再开工。计划里如果出现了你没提到的模块，当场收窄。

二、按"行为不变"分层推进

阶段	动作	验收
准备	补/跑通现有测试，确认基线全绿	改动前测试就是绿的
结构调整	移动文件、改名、抽函数，不改逻辑	每步后测试仍绿
逻辑优化	在行为不变前提下简化实现	测试 + 人工抽验
收尾	清理、更新注释与文档	diff 与计划一致

三、回归防护的三个抓手

频繁提交。每完成一个可独立验证的小步就提交，出问题随时回退到上一个绿点。不要让代理一口气改几十个文件再让你看。跑全套检查。每次大改后都要跑测试、类型检查、lint，不要只看"代理说改完了"。人工抽查 diff。重点看它有没有偷偷改变行为、有没有改动你声明不许动的部分。大重构里，代理的执行力是杠杆，但安全网必须由你亲自拉起来。