用途：把代码实现从 API A 迁移到 API B，包括框架升级、版本升级、库替换或内部 API 下线，同时保持调用方观察到的行为不变。实现可以移动，契约不能变。若新 API 本应行为不同，那属于重写，应先重新归类。
主要能力与规则：行为保持需被证明而非假设，优先用差分对比（旧路径经 shim 保留并与新路径对比），否则用黄金输出或属性测试；测试失败要先调查，不能为适配新结果而改测试。按波次执行，每波是最小的原子改动，结束后代码仍可编译并通过检查，每波结束都要粘贴测试与检查输出。逐文件迁移，禁止批量 codemod、sed 或 shell 循环。全程跟踪旧 API 调用点直至归零，完成意味着在显式跟踪的 shim 之外旧 API 调用点为 0，并用粘贴的搜索证明。除调用语法外，还要审计动态分发、字符串引用、生成代码、测试夹具与快照、反射等。每个 shim 引入前必须有可验证的移除条件（路径、转发目标、可机械检查的 removable-when 条件）。不得夹带语义改进，发现的问题记为 finding candidate。粘贴真实输出，命令从 AGENTS.md 解析，未定义时询问，且不得对自己的工作出具评审结果。
使用方式：开始前打开 references/task-template.md 并复制到任务文件，随做随填，其中包含调用点跟踪表、shim 表、每波证据槽、beyond-the-grep 审计与自审。任务包使用 kit 的任务模板，波次计划位于 change plan。
适用场景：内部 API 替换、框架/语言/库升级等迁移任务。
限制：这些是评审包检查的约定，编辑时无强制机制；若套件是唯一 oracle，需记录其为何足够。自审门要求每波绿色、调用点归零有粘贴证明、beyond-the-grep 审计完成、shim 移除条件齐备、等价性检查粘贴、无半迁移文件或 TODO、未对自己的工作出具评审结果。