用编程 Agent 先审计依赖再迁移
文章以 Jest 迁移到 Vitest 为例,让 Lemon Code 先扫描仓库、梳理旧 API 的使用位置和相关测试。人工审阅迁移计划后,Agent 再分步修改和运行测试,并保留可回滚的检查点。
AI 深度解读
把 Jest 迁到 Vitest,第一步可以先让 AI 读仓库,交一份迁移计划。作者用 Lemon Code 演示了这套流程:先找出旧 API 的调用点、需要迁移的配置,以及能验证现有行为的测试。人审过计划,再让代理逐步修改。
这套流程最实用的地方,是能在代码变动前发现漏项。第一批该改什么、跑哪些测试、失败后退到哪里,都可以提前定下来。原文给出了操作步骤,实际能省多少时间还没有数据。
先把迁移计划写到能审的程度
按原文描述,Lemon Code 可以在浏览器中打开,入门无需安装或 API key。它读取本地检出的项目,能看到真实代码、测试环境和配置。工具有 5 个代理,分别负责规划、编辑、运行测试、调试和审查,过程中会展示读了哪些文件、跑了哪些命令、哪些检查通过了。
下面这段提示词把第一轮任务限定为盘点影响范围和安排迁移顺序。
Read this repo. We are migrating from Jest to Vitest.
Do not change any code yet. Produce a plan:
which files import Jest APIs, what order to change
them in, which tests pin current behavior, what
config has to move, and what is likely to break.
第二行的 Do not change any code yet. 把修改留到人工审阅之后。这里说的「锁定现有行为」,就是找出能回答「迁移前后,同一段业务逻辑的结果是否一致」的测试。有了这些测试,计划里的每批改动才有明确的验收依据。
把计划当成一次代码审查
代理列出涉及旧 API 的文件、建议的修改顺序和潜在风险后,仓库维护者要用自己掌握的信息逐项核对。比如,一份计划列齐了测试文件,却遗漏了测试配置的入口,就让代理先补齐,再回头确认原定的迁移顺序是否还成立。
版本支持、弃用项和团队约定也要由维护者拍板。代理能搜集线索,但升级到哪个版本、哪些旧用法要一起处理,都取决于项目的实际约束。原文没有给出 Jest 或 Vitest 的具体版本,也没有列出某个仓库的实际迁移清单。
每批改动都要有验收和回退点
计划过审后,作者建议先执行第一步。看完这一批的 diff 和测试结果,再决定是否继续。某一步出错,就退回对应检查点,调整方案后再跑。改动范围越小,测试失败时就越容易判断是哪项变更引起的。
原文称 Lemon Code 在浏览器和 Mac 上免费,也提到已有 Claude Code、Codex 或 Gemini CLI 的读者可以沿用自己的代理,并使用自己的订阅或 API key。
我的判断
我认同把计划当成第一份交付物。和直接让代理做完整迁移相比,先审计划能更早发现范围和顺序上的问题。和人工搜索旧 API 相比,代理的潜在价值是把调用点、配置和验证步骤串起来,但仓库里已有的搜索命令和测试结果仍然适合用来复核它的清单。
原文是一篇操作教程,没有展示完整迁移的 diff、测试记录或耗时,也没有和人工迁移做对照。效率收益只能当作经验判断。还有一个前提是测试得覆盖你关心的行为。如果现有测试没有覆盖某个关键分支,迁移后全绿也无法验证那个分支。
能拿来做什么
- 前端或 Node 项目迁移测试框架时,先让代理交一份按文件列出的影响清单,把旧 API、配置入口和负责验证现有行为的测试对应起来。
- 审计划时,用仓库现有的搜索和测试命令抽查高风险项。遇到遗漏,先让代理更新清单和执行顺序。
- 开始执行前给当前状态留一个可回退的 Git 检查点,只授权代理跑第一步。核对这批 diff 和约定的测试结果,再放行下一批。