用途：为 Nx 插件编写第一方迁移，覆盖会破坏或改变行为的变更，例如移除、重命名、弃用选项/标志/执行器/生成器 schema 字段。
主要能力：把变更拆解为迁移需求，并为每项选择处理方式，包括不处理、版本准入、普通依赖升级、条件依赖变更、源码转换、移植上游迁移、运行上游 codemod、仅提示、混合形态。确定性可自动化的部分优先用迁移生成器实现，仅提示是最后手段。
使用方式：按目录约定放置文件，路径形如 packages/<plugin>/src/migrations/update-<major>-<minor>-<patch>/<name>.ts，配套 .spec.ts 与同名 .md；提示文件基名需与 .ts 不同。条目写入顶层 generators 段，键为 kebab-case 且文件内唯一。版本字段是门控而非标签，需选择目标发布列车；requires 针对落地版本求值，常见为仅下界 >=N。packageJsonUpdates 组按来源主版本窗口 >=N.0.0 <N+1.0.0 门控，按最旧来源主版本在前排序。
适用场景：Nx 插件维护者在发布新主版本、依赖升级或行为变更时，需要让用户工作区自动迁移。
限制：不要编写执行器到推断的转换，也不要为未发布或推测的上游行为编写迁移。不要仅依赖 @nx/plugin:migration 生成器输出，它只生成空桩。具体命令、脚本与模板细节以资料为准，部分内容暂未提供。