用途：面向 Espressif ESP32 生态的嵌入式工程辅助技能，用于芯片选型、编写 C/C++ 固件，并在引脚与协议配置上做安全校验，避免硬件损坏或协议冲突。
主要能力：提供芯片家族选型参考（原版 ESP32、S2、S3、C3、C6、H2、P4 等）；按触发条件加载参考文档，如引脚库、芯片特性、协议速查（I2C、SPI、UART、PWM、1-Wire、CAN、ADC、DAC）、电气约束、常见器件、LVGL 与 Waveshare 板卡资料。强调安全护栏：GPIO12 启动时拉高可能将 flash 电压设为 1.8V 而损坏 3.3V 模块；原版 ESP32/S2/S3 上 ADC2 不能与 Wi-Fi 同时使用；GPIO34-39 仅输入且无内部上下拉；重映射时用 gpio_func_sel(pin, PIN_FUNC_GPIO) 清除初始 IOMUX 功能。内存方面区分 DRAM、IRAM、RTC 内存与 PSRAM，建议使用 MALLOC_CAP_DMA、MALLOC_CAP_SPIRAM 等能力分配，采用 RAII 与智能指针，加入看门狗并保持中断服务程序简短。
使用方式：ESP-IDF 使用 idf.py 的连字符语法（set-target、menuconfig、build、flash、monitor、erase-flash），如 set-target esp32s3；PlatformIO 通过 platformio.ini 管理多环境，可切换 espidf 与 arduino 框架。工作流为解析 MCU 型号与协议、检测冲突、加载参考、分配引脚、校验并输出引脚表与初始化代码。脚本接受统一 JSON 输入（platform、variant、module、wifi_enabled、pins 等字段），校验命令：python scripts/validate_pinmap.py --format json < input.json；生成代码：python scripts/generate_config.py --format json --framework arduino|espidf < input.json。
适用场景：ESP32 硬件选型、固件开发、引脚规划与冲突排查、外设与显示接入。
限制：脚本校验与代码生成仅支持 esp32、esp32s2、esp32s3、esp32c3、esp32c6；C2、C5、H2、P4 仅有参考文档，暂不支持脚本校验与生成。其他收费、平台与效果信息暂未提供。