用途：作为 ESP32 在 ESP-IDF 工具链下的工程入口，负责工程骨架、构建、依赖管理与 v5→v6 迁移排障；并发模型与业务代码交给 esp32-freertos，引脚与外设驱动交给 esp32-peripherals，OTA、安全启动、配网、低功耗、调试、上板验收等意图各自移交对应技能。
主要能力与使用方式：新建工程按 Workflow A，依次执行 idf.py create-project hello_idf、idf.py set-target esp32s3、idf.py menuconfig、idf.py build、idf.py -p /dev/ttyUSB0 flash monitor。加第三方组件用 idf.py add-dependency <ns/name=版本> 写入 idf_component.yml，依赖落在 managed_components/ 并生成 dependencies.lock，损坏可用 idf.py reconfigure 重建。移植或跨大版本升级走 Workflow B，先 idf.py --version 确认本机版本，按报错定位 legacy 驱动移除或 esp-mqtt 转组件管理器问题，并读 v5-to-v6-migration。组件与版本锁定走 Workflow C，dependencies.lock 与 managed_components/ 都纳入版本控制。若任务涉及 OTA、安全启动、配网、低功耗或调试，本技能只建骨架，实施移交相应技能。
适用场景与限制：适合 ESP-IDF 工程搭建、构建烧写、迁移与 CI 可复现构建。事实基线为 ESP-IDF v6.1，走读日期 2026-09-02，不自动更新；具体版本号引用须带日期并运行时核验官方 releases 与文档。target 必须与实物丝印或原理图核对；分区偏移不确定时禁止编造，让工具自动排布。烧写会改写设备状态，需先确认串口与权限。无真实硬件证据时，汇报只能标注 Build Verification Only，不能视为板子可用。本技能不采集、不存储、不外发用户数据、Wi-Fi 凭据或密钥。