用途：把开发板、外围电路、固件与主机工具链视为一个整体，完成 ESP32 系列（ESP32、S2、S3、C2、C3、C5、C6、H2、P4 等）的固件构建、配置、烧录、测试、调试与恢复。任务完成以硬件边界观察到预期行为为准，而非仅编译或烧录成功。
主要能力：识别板型、SoC 家族、模块、Flash/PSRAM 容量、USB 传输、供电与板卡版本；按产品约束选择 ESP-IDF、Arduino/PlatformIO、MicroPython、CircuitPython、ESPHome、Zephyr、Rust 或 NuttX；覆盖 GPIO、ADC、DAC、PWM、触摸、I2C、SPI、UART、I2S、RMT、PCNT、TWAI/CAN、USB 等外设与总线；涉及 Wi-Fi、BLE、ESP-NOW、Zigbee/Thread、睡眠、OTA 与量产功耗行为；提供调试、恢复与安全状态诊断，以及硬件测试自动化。
使用方式：先做只读发现，运行 python3 scripts/esp32-preflight.py（可加 --json），PlatformIO 环境可用 pio device list --json-output，mpremote 环境可用 mpremote connect list。按“电源与启动、串口日志、单个 GPIO、单条总线、总线扫描或回环、设备身份寄存器、原始读数、校准、应用行为”逐层点亮。首次烧录或改动硬件前确认目标端口、芯片家族、镜像/分区布局、回滚或重烧路径与电气安全，不猜测烧录偏移。提供 templates/hardware-bringup.md、hardware-test-plan.md、component-contract.md、esp-idf-main.c、platformio.ini、micropython-i2c-scan.py、esphome-device.yaml、zephyr-esp32.overlay 等模板。
限制：ESP32 GPIO 通常不耐 5V，需按数据手册限值并加电平转换或驱动；不得用 GPIO 直接驱动电机、继电器、螺线管、舵机、大电流 LED 或大容性负载；GPIO 编号安全性因芯片、模块、板卡与启动模式而异；不要以擦除 Flash 作为通用排障第一步；安全启动、Flash 加密、eFuse 与下载模式限制可能不可逆；密钥不得写入公开模板或版本控制。不适用于 PCB 布局认证、射频/天线设计、市电作业、功能安全认证、医疗设备或缺少权威数据手册的元件；非 ESP32 目标应使用对应平台技能。