用途：该技能是 Home Assistant 集成迁移的入口，针对两类迁移问题提供指引。
配置条目版本迁移：当 config entry 的 schema 发生变化，例如重命名键、增加必填字段时，需要递增 VERSION 并实现 async_migrate_entry。适用时机是修改了 entry.data 或 entry.options 中存储的内容，且现有用户数据需要被转换。完整模式与模板参见 ha-config-migration。
弃用修复：升级到更新的 HA 版本时，已弃用的导入、类型标注和 API 模式可能产生警告或直接失败。2024 至 2025 年的弃用模式及前后对比示例参见 ha-deprecation-fixes。适用时机是 HA 日志出现弃用警告，或正在提升 hacs.json 中的 homeassistant 最低版本。
每次版本升级的迁移检查清单：查看 Home Assistant 开发者博客中的破坏性变更；在代码中搜索已弃用的导入；运行 check-patterns.py 检测常见问题，命令为 python3 "${CLAUDE_PLUGIN_ROOT}/scripts/check-patterns.py" custom_components/my_integration/；更新 hacs.json 中的最低 HA 版本；针对目标 HA 版本进行测试。
相关技能：配置条目迁移对应 ha-config-migration，弃用模式对应 ha-deprecation-fixes，集成结构对应 ha-integration-scaffold。
限制：资料未提供该技能支持的具体 HA 版本范围、脚本的完整检测项、安装方式及收费信息。