17. 大规模改动管理


任务拆分

大型任务必须拆分后再交给 AI 执行:

❌ 不好:"重写整个项目"
✅ 好的:"请先分析当前的认证模块,制定从 session 迁移到 JWT 的详细计划"

分阶段执行

我们分 5 个阶段完成这次数据库迁移:
阶段 1:创建新表结构(不删除旧表)
阶段 2:编写数据迁移脚本
阶段 3:修改应用层代码使用新表
阶段 4:验证数据一致性
阶段 5:清理旧表和遗留代码

现在开始执行阶段 1。

模块化重构

将 utils.ts(800行)拆分为独立模块:
1. string-utils.ts — 字符串处理
2. date-utils.ts — 日期处理
3. validation.ts — 数据验证
4. formatters.ts — 格式化函数

同时更新所有引用这些函数的文件。

方案先行

在执行大规模改动前,让 AI 先制定方案:

请不要动手写代码,先分析以下重构任务并输出执行方案:
- 影响的文件列表
- 每个文件的预期改动
- 潜在的风险点
- 建议的执行顺序

改动审计

每次 Agent 完成改动后:

  1. 逐文件审查 diff
  2. 运行测试确保无回归
  3. 运行 lint 确保风格一致
  4. 满意后再提交 Git