该技能为 ESP32 / ESP-IDF 嵌入式开发提供系统化最佳实践指导，适用于编写新固件、审查实现方案、学习嵌入式模式、调试问题和优化代码。
项目结构：推荐标准 ESP-IDF 布局，main 目录含 CMakeLists.txt、main.c、Kconfig.projbuild 与 include/，components 下放自定义组件（含 CMakeLists.txt、component.c、include/），另有 CMakeLists.txt、sdkconfig.defaults、partitions.csv 与 README.md。组件组织强调单一职责、在 include/ 暴露清晰公共接口、私有实现放 src/、记录依赖。
FreeRTOS：任务函数需在循环中通过 vTaskDelay 让出以避免看门狗，任务不应返回，若返回则调用 vTaskDelete(NULL)。典型任务栈起始 4096 字节，用 uxTaskGetStackHighWaterMark() 测量实际用量并留 25% 余量，摄像头/网络任务可能需 8192 以上。同步建议使用互斥量并设超时，生产环境避免无限等待；任务间通信优先用队列，发送时设超时并处理队列满。
内存管理：固定资源优先静态分配（xTaskCreateStatic 配合 StaticTask_t 与 StackType_t），可变大小资源用 heap_caps_malloc 并检查 NULL、用后 free；字符串用 snprintf 防止溢出，常量字符串用 static const 保持于 flash。
错误处理：ESP-IDF 函数返回 esp_err_t，逐层检查并用 esp_err_to_name 记录，仅致命错误用 ESP_ERROR_CHECK；非致命错误应优雅降级，例如 WiFi 失败时转离线模式。
外设初始化：给出 gpio_config、I2C 主模式配置与安装示例。中断服务程序应极短，用 IRAM_ATTR 标记，仅向队列发送信号，重处理放到任务中；从 ISR 调用的函数也需 IRAM_ATTR，并注意 IRAM 约 128KB 限制。
WiFi：使用事件循环处理连接与断线重连；WiFi 占用内存较大，内存密集应用应启用 PSRAM，并用 CONFIG_SPIRAM_USE_MALLOC 扩展堆。
日志：分为 ERROR、WARN、INFO、DEBUG、VERBOSE 五级；生产环境通过 menuconfig 降低级别（至少 WARN），并注意日志字符串占用 flash。
电源管理：轻睡眠通过 esp_pm_configure 配置频率与 light_sleep_enable；深度睡眠用 esp_sleep_enable_timer_wakeup 设置定时唤醒后调用 esp_deep_sleep_start。更多细节可查阅 ESP-IDF 编程指南、FreeRTOS 文档与 ESP32 技术参考手册。该资料为实践指南，未提供具体收费、平台或版本要求。