用途：migration-wizard 定义执行迁移技能向导的通用协议，是父级契约。具体迁移子技能（如 trustworthy-services）在其 frontmatter 中提供声明式数据，本协议规定如何执行这些数据。类比：子技能描述“安装什么”，本协议描述“怎么做”。PM 代理在执行任何迁移子技能时都必须加载本协议，先读取子技能的 frontmatter 和正文了解服务背景，再按以下五个阶段执行。
子技能 frontmatter 契约：state_key（必填，用户选择跟踪标识）、services（必填，服务列表）、recommended（可选，默认 true）、check_commands（必填，阶段1检测命令，全部退出 0 则跳过安装）、health_checks（可选，安装后探测的 {url, service} 守护进程列表）、system_requirements（可选，含 min_ram_gb、min_disk_gb、tools_required）、install_commands（必填，或 install_script）、install_script（可选，子技能目录下的脚本路径）、verify_commands（必填，阶段4命令，须全部退出 0）、verify_scripts（可选）、post_install_notes（可选）。子技能正文为自由格式的背景说明，不含流程。
执行流程。阶段0（强制首步）：在做出任何其他操作前先向用户提供三个选项——立即安装、稍后提醒（延后24小时）、永不（永久拒绝），并用 record-choice.sh 立即记录选择；若选延后或永不，确认后停止，不得进入阶段1。
阶段1 检测：运行全部 check_commands，若全部退出 0 则视为已安装，自动完成并停止；若定义了 health_checks，还须用 check-service-health.sh 探测，全部通过才算完整安装；部分通过则记录缺失项后进入阶段2。
阶段2 系统能力检查：运行 check-system-capabilities.sh 检查内存与磁盘；再按 system_requirements.tools_required 逐个运行 tool.check，缺失则显示 install_hint 并停止（不记录拒绝）；资源不足则警告并让用户选择继续、永久拒绝或延后24小时。
阶段3 安装：交由 local-ops 代理执行，优先用 install_script，否则按序运行 install_commands；任一步失败须如实向用户报错，并提供重试、延后或拒绝选项，不得记录完成。
阶段4 验证：重跑 verify_commands，全部退出 0 后再运行 verify_scripts；失败须指出具体失败命令，不记录完成，可重试或人工排查。
阶段5 完成：验证通过后记录 complete，并向用户简要说明安装内容、使用方法、配置变更及 post_install_notes，建议重启 Claude Code 并运行 claude-mpm doctor 验证。
错误处理：用户中途改主意按延后处理（除非说 never）；无法解决的错误通过 /mpm-bug 提交并延后24小时；阶段4失败不记录完成，下次会话会重新检测；用户明确要求跳过检测时尊重选择但需警告重装可能破坏现有安装。
共享脚本位于 .claude/skills/migration-wizard/scripts/：record-choice.sh、check-service-health.sh、check-system-capabilities.sh、list-pending-migrations.sh。具体子技能列表、价格、平台支持等信息暂未提供。