用途：write-migration 用于执行迁移或升级任务，把实现从 API A 移到 API B，包括框架升级、版本升级、库替换、内部 API 下线，同时保持调用方观察到的行为不变。实现移动，契约不动。若新 API 本应行为不同，那属于重写，应先重新标记任务。
主要能力与规则：行为保持需被证明而非假设，可用差分对比（旧路径放在 shim 后保持可达，直到差异清零），否则用黄金输出或基于属性的检查；测试通过只覆盖已测内容。按波执行，每波是最小的原子改动，结束时代码仍可编译并通过检查，每波结束运行测试与检查命令并粘贴输出。逐文件迁移，禁止批量 codemod、sed 或 shell 循环。全程跟踪旧 API 调用点数量到零，完成意味着在显式跟踪的 shim 之外为零，并用粘贴的搜索证明。除调用语法外，还要审计动态分发、字符串引用、生成代码、测试夹具与快照、反射。每个 shim 引入前必须有可验证的移除标准（路径、前向目标、可机械检查的 removable-when 条件，例如 git grep -c '<old-API>' src/ 返回 0）。不得夹带语义改进。粘贴真实输出，命令从 AGENTS.md 解析，未定义时询问，且不得对自己的工作写评审结果。
使用方式：先做变更计划（基线、波次、回滚），本技能负责执行部分。任务包使用套件的任务模板，波次计划位于变更计划中。附带 references/task-template.md 作为工作笔记脚手架，含调用点跟踪表、shim 表、每波证据槽、超越 grep 的审计与自审。
适用场景：框架或库升级、版本升级、内部 API 替换与下线等需要保持外部行为的迁移。
限制：这些是评审包检查的约定，编辑时没有强制机制。资料未提供具体安装命令、收费、平台或效果信息。