让AI编码代理去现代化一个遗留的Angular模块,它三十秒内就能给出一份计划。在见过的多次运行里,这份计划的第一句都是“删除”。

打开网易新闻 查看精彩图片

这就是问题所在。一个已经在生产环境跑着的模块,被当成可以推倒重来的草稿。下面拆解这套计划为什么会崩,以及一套能活下来的迁移方案长什么样。

具体案例:一个典型的遗留模块

演示仓库里的 libs/legacy/transfers 是一个NgModule,组件里用着 *ngIf、手动订阅、markForCheck() 调用,还自带一张转账限额表。应用的新一侧已经有信号存储 AccountsStore,规则放在 libs/domain 里。

对它说“把这个迁移到信号”,典型计划有四步:删除 LegacyTransfersModule、原地转换组件、写一个 validateTransfer() 辅助函数、更新测试。听起来很干净,实际上是一次性大爆炸,会在三个地方断掉。

  • 你不知道的调用方。老代码库里的遗留代码有代理没搜到的使用者:一条路由、另一个页面上的链接、一个守卫。删掉源码,你会在生产环境里遇见它们。
  • 没有停下来发布的时机。原地转换意味着新版本还没跑通,旧版本已经没了。做到一半,没有任何东西可以发布,唯一的退路是回滚。
  • 无法评审的差异。没人会读一个放在单个拉取请求里的迁移。评审退化成“测试过了,发吧”,而那些测试是写代码的同一个代理改的。

判断的线索就在第一行:任何以“删除X”开头的迁移计划都是错的。

降级,而不是删除

能活下来的方案有三步,每一步都能独立发布。

第一步,在旁边建。新功能放进自己的库 libs/feature/transfers,与遗留库并排。遗留模块继续服务那个页面,原封不动。

第二步,切换路由。新表单验证通过后,app.routes.ts 里改一行。遗留模块就此被降级:还在代码树里,但不再服务任何人。如果生产环境出问题,切回去也是同样一行的差异。

第三步,最后再删。当没有任何东西再导入遗留库时,删除它只是移除代码,不改变任何行为。演示仓库的lint规则只允许应用导入 type:legacy 的库,所以没有现代库能依赖它。删除之后,一次通过的typecheck证明应用也不再依赖它。

如果先删再切,编译器会立刻拦住你:error TS2307: Cannot find module '@atlas/legacy-transfers' or its corresponding type declarations. 这才是你想要的那种删除——编译器替你检查过。

先要计划,别要代码

不要直接让代理写代码,先让它给计划,然后拿规则去对。提示词里明确要求:读 AGENTS.md 和 libs/legacy/transfers/src 下的每个文件,提出一份迁移计划,只给计划——编号步骤、每一步创建/修改/删除哪些文件、路由 /transfers/new/:accountId 在哪一步切换。不写代码,不编辑任何文件。

当那四步计划回来时,评审很短:

  • 先删模块:不行。遗留模块继续服务 /transfers/new/:accountId,直到新功能验证通过。删除放在最后,单独一次变更。
  • 原地转换:不行。在旁边建,放进 libs/feature/transfers,保证任何时候都有东西可发布。
  • 写 validateTransfer() 辅助函数:它重复了已经存在的规则。规则文件要求新增魔法值之前先 grep libs/domain,canTransfer() 和它的提示信息就在那里。
  • 更新测试:不行。已有断言永远不为让差异通过而修改。如果某条断言是错的,代理要在拉取请求里说明并停下。

然后是三份任务文件,而不是一个拉取请求,每份都有自己的体量上限:任务000锁定遗留代码当前的行为,任务002在旁边建新功能并切换路由,任务003删除遗留库。

有了这些任务文件,代理构建出的组件和代码库其余部分风格一致。演示仓库的参考实现里只有信号和 computed,规则来自一次领域调用 canTransfer(),而它本来就有测试。没有订阅,没有 markForCheck(),没有限额表。

任务文件还要求代理报告那一处真实的行为变化:遗留的限额表忽略了今天已经发生的转账,canTransfer() 会把它们算进去。那张重复的表一直在掩盖一个bug,拉取请求把它说出来,而不是悄悄塞进去。

周一上手的三条:以“删除”开头的迁移计划,退回去;在旁边建、切路由、最后删;让代理先提计划再写代码,拿你的规则读一遍,五分钟。