该技能面向应用仓库的 ESP-IDF 6.0 迁移工作流。适用场景：从 ESP-IDF 4.4 或 5.x 迁移到 6.0、切换到 6.0 后的故障分类、审查被移除的 API、被移动的组件、工具链变更、配置及运行时回归。早于 4.4 的版本应先制定分阶段迁移计划并与用户确认范围与验证方式，不应一次性直接跳转。
资料来源优先级：以官方在线 ESP-IDF 迁移指南为主要依据，先确定确切的目标补丁版本并使用 /en/<TARGET_IDF_VERSION>/ 下的文档，迁移决策不使用 /latest/；本地匹配检出仅作辅助。参考 references/migration-paths.md 获取累积指南链，references/version-summary.md 用于路由。
工作流：一、建立原始基线，检查仓库状态并保留无关改动，从 idf.py --version、CI、项目文档、IDF_PATH、EIM 确定源版本，不明确时停下询问；在原环境构建并运行相关测试，记录目标、警告、二进制与分区大小、依赖版本、配置默认值及预期运行时行为；仅在明确授权后烧录，并确认端口与设备。二、选择累积迁移路径，5.5 项目从 5.5 到 6.0 指南开始，5.4 或更早需先审阅所有中间指南。三、切换环境到目标 IDF，优先使用 EIM：eim list、eim run "idf.py --version" <TARGET_IDF_VERSION>、eim run "idf.py -B build-v6 build" <TARGET_IDF_VERSION>、eim install -i <TARGET_IDF_VERSION>（安装缺失版本需授权）；使用独立构建目录如 build-v6，默认不执行 fullclean，执行 idf.py set-target 前需询问。首次构建若报旧 CMake 基线，将首行更新为 cmake_minimum_required(VERSION 3.22)。四、首次构建后按类别归集失败：构建系统/链接器、GCC 或头文件/工具链、被移除或移动的组件、不支持组件、驱动依赖拆分、子系统 API 变更、配置与 Kconfig 语法问题；参考 references/common-breakpoints.md 和 references/build-errors.md。五、按子系统修复，注意 CMake 基线、Kconfig v3 语法、GCC 15 警告、Picolibc 头文件差异、用组件注册表依赖替换移除的树内驱动、显式更新 REQUIRES 与 PRIV_REQUIRES、esp_driver_* 拆分、sdkconfig.defaults 与生成配置、不手动编辑 dependencies.lock 或 managed_components/、审查分区与 OTA 回滚影响。六、按批次重建并在目标版本下重复测试矩阵，对比警告、大小与行为，授权后烧录并记录日志，报告源与目标版本、测试、证据及未验证项。限制：不要跳过中间迁移指南，不要将本地 6.0 检出视为比官方文档更权威，不要在理解破坏原因前抑制警告，不要假设旧驱动依赖仍可传递获得。