遗留代码现代化：AI 把老代码迁移到新框架

🔧 Step 0：先确认外部工具配置

⚠️ 本案例依赖外部工具（Telegram/Notion/飞书等），先确认已配置 👉 查看常用工具配置指南 →

真实应用

dev.to/ide.com 报告：“Legacy Modernization: It is exceptionally proficient at deciphering and modernizing legacy languages like COBOL, automating the grueling analysis phases of enterprise server migrations.”

虽然说的是 COBOL 等企业语言，但同样的方法适用于前端 jQuery→React、后端 PHP→Go/Node 等常见场景。

解决什么问题

遗留代码迁移的痛苦：

• 代码量大（几十万行），人工逐行改不现实
• 业务逻辑藏在旧代码里，理解需要几个月
• 改了 A 破了 B，牵一发动全身
• 老代码没有测试，不敢改

前置条件

• OpenClaw 已安装
• coding-agent 技能
• 遗留项目代码库

迁移流程

第一步：分析和规划

分析这个 jQuery 项目，给出迁移计划：
- 总共多少个组件/模块
- 按复杂度排序
- 建议迁移顺序（从最简单的开始）
- 识别可以废弃的代码

📊 项目分析

总计 120 个 jQuery 组件

• 简单（纯展示）：35个 → 建议 1-2 天
• 中等（有交互）：60个 → 建议 1 周
• 复杂（复杂状态管理）：25个 → 建议 1-2 周

建议迁移顺序：

1. 先迁移 35 个简单组件（积累经验）
2. 再迁移 60 个中等组件
3. 最后处理 25 个复杂组件

可废弃代码： 18 个组件已不再使用

第二步：逐模块迁移

帮我把这个 jQuery 组件迁移到 React + TypeScript：
[粘贴旧代码]

要求：
1. 保持完全相同的功能和交互
2. 使用 TypeScript
3. 使用 React Hooks
4. 写单元测试
5. 迁移说明（改了什么、为什么）

第三步：验证和合并

运行测试确认迁移后的代码和原来的行为一致
如果有差异，列出来让我确认

预期结果

• 迁移速度提升 5-10 倍
• 每个迁移后的模块都有测试覆盖
• 逐步迁移，不影响现有系统
• 完整的迁移记录和文档

踩坑记录

AI 不理解业务逻辑

症状：生成的代码功能正确但业务逻辑有误。

解法：每个模块迁移前先让 AI 分析业务逻辑，你确认后再开始写代码。复杂模块建议人工主导、AI 辅助。

迁移过程中接口变了

症状：后端 API 在迁移过程中被其他人改了。

解法：先固定 API 接口文档，迁移期间 API 变更需要同步到迁移计划中。

不满意怎么调

• 不想用 React → AI 可以迁移到 Vue/Svelte/任意框架
• 后端迁移 → PHP→Node、Java→Go、Python2→Python3
• 数据库迁移 → MySQL→PostgreSQL、SQL→ORM