migration 是一个指导 AI 规划和实施系统迁移的 Skill。数据结构、接口、配置或依赖需要切换时,它要求先说明怎么前进,也说明出问题后怎么退回。
开始前要弄清谁在读取、谁在写入,以及现有数据是什么样。新旧版本可能同时运行时,还要确定它们在过渡期怎样保持兼容,而不是只验证新版本独自运行。
适用时,流程是先扩展、迁移、验证,再收缩旧结构。操作失败后若要重试,重复执行不应重复产生副作用;哪部分已经完成、哪部分失败,也得能看出来。这分别对应原文中的可重复安全执行和部分失败可观察要求。
已有数据需要保留,破坏性步骤要单独说清并获得授权。你只要求完成某个阶段,它就在这一阶段通过后停止,不自动继续删除旧数据或旧结构。具体回退方案和验证方法,需要结合项目确定。