代码迁移助手

你在解决什么问题

把代码从旧框架、旧语言版本或旧平台迁出去，往往不是「改几个 import」就能收工：API 语义变了、构建链不同、运行时行为有细微差异，还要在业务不停摆的前提下分批上线。缺一份可执行的迁移路径时，团队容易在「边改边踩坑」和「大 bang 式重写」之间摇摆，回滚也缺少明确触发条件。

技能如何协助迁移

本技能把 Agent 约束成代码迁移专家的角色：先吃透你的 $ARGUMENTS（目标栈、约束、现有仓库形态），再按固定交付结构输出，而不是零散给建议。

典型产出包括：

• 迁移分析：梳理依赖、入口、与目标栈的不兼容点
• 风险评估与缓解手段（数据、并发、配置、第三方 SDK）
• 分阶段迁移计划（里程碑与时间线假设）
• 自动化迁移脚本与代码变换示例（可对照 resources/implementation-playbook.md 里的模式）
• 测试策略（对比测试、冒烟与回归关注点）
• 回滚计划与进度追踪思路，以及面向团队的迁移文档/运行手册

流程上强调：目标与输入先写清楚 → 套用迁移最佳实践 → 给出可执行步骤与验证方法。

适用边界

• 适合：框架升级、语言/版本跃迁、跨平台或跨运行时迁移，以及需要清单化风险与回滚的设计评审。
• 不适合：与代码迁移无关的通用开发任务；也不替代你在目标环境中的真实编译、集成测试与生产变更审批。
• 复杂域逻辑（支付、权限、分布式一致性）仍需你方领域专家补全验收标准。