遗留系统理解与渐进改造

真实工作中大量代码是遗留系统：没有文档、测试缺失、命名混乱、历史包袱重。用代理改遗留代码，最大的风险是"它以为自己懂了，其实没有"。本节讲如何在不可靠的信息基础上，安全地理解并渐进改造遗留系统。

一、先理解，后改造

面对遗留代码，把"让它改"放到最后一步。第一步永远是只读理解：让代理阅读一段你不熟悉的逻辑，用它自己的话复述这段代码的输入、输出、副作用和边界条件。复述之后，你要亲自对照真实代码验证——它哪里说对了、哪里是猜的，当场指出。不要让错误理解进入后续改动。

二、用"特征测试"锁定现有行为

遗留系统最怕"改着改着把本来正常的行为弄坏了"。在动任何逻辑之前，先让代理为关键路径补一组 characterization tests（特征测试）——不追求好，只追求把当前实际行为钉死。有了这张安全网，后续重构哪怕改得面目全非，只要测试还绿，就说明行为没变。

三、小步渐进，拒绝大重写

对遗留系统，最危险的指令是"把这个模块重写一遍"。正确姿势是：一次只解决一个小问题，每次改动都可独立提交、可回滚、可验证。把大目标拆成"先补测试、再改名、再抽函数、再改逻辑"一串小步，每步都保持系统可用。代理擅长在小步里执行，但拆步的判断必须由你来把关——这是人与代理在遗留系统上最典型的分工。