ESP32 嵌入式开发大师技能
为 ESP32 硬件选型、GPIO 引脚校验与固件代码生成提供专家级防护，主动规避烧砖与协议冲突。
该技能为纯本地咨询与脚本校验，不请求网络、不写入敏感数据、权限需求极小；SKILL.md 明确披露防硬件损坏的安全策略（GPIO12 陷阱、ADC2/Wi-Fi 冲突、flash 引脚保护），数据流透明。扣分点：发布者身份未验证，脚本源文件未在本次证据中出现（仅 conftest/helpers），无法核实脚本无副作用与回滚路径，确认与隔离机制未声明。
文档内部自洽：JSON schema 与字段表、变体支持矩阵（脚本支持 5 个变体、文档覆盖 9 个）说明清楚，README 给出可复现的调用命令和 pytest 测试说明，且存在 conftest.py 证明测试框架真实存在。但为静态评审且未执行：脚本本体、fixtures、测试覆盖范围不可见，异常输入下的失败反馈质量无法核实，按锚点不得高于 10。
触发条件写得相当精确（ESP32/ESP-IDF/PlatformIO/LVGL/Waveshare 等关键词），适用与非适用边界通过支持矩阵显式声明（C2/C5/H2/P4 仅文档不支持脚本），场景清晰。扣分：全部内容为英文，无中文支持；未讨论中国大陆网络可达性（依赖 Claude Code 生态）；触发词宽泛（如 'embedded systems'）可能过度触发。
结构分层良好：SKILL.md 按需加载 references 的渐进式披露、安装说明、变体支持矩阵、贡献与扩展指南、MIT 许可证、版本号 1.0.0 齐全。扣分：无 CHANGELOG 或版本历史说明；维护责任仅指向个人账号 'ezrover'/'Vibe Coder'，无明确更新路径；已知限制披露部分依赖 README 而非技能本体。
价值主张明确：引脚防错校验 + 样板代码生成 + 芯片选型，直接输出 JSON/代码/表格，相比手动查数据手册有明显边际价值，且防硬损坏检查是真实痛点。扣分：静态评审无法验证生成代码的正确性与直接可用性，代表性输出未被执行复现，按锚点不得高于 7。
存在主材料：结构化的 references 索引、详细的 JSON schema、50 个自动化测试的 conftest 与断言助手可审计，README 提供复现命令。扣分：仅看到测试基础设施而非测试用例与 fixtures 本体，无 CI 工作流证据，安全检查表（如 flash 引脚范围）未与来源交叉印证，第三方执行证据缺失，按锚点不得高于 5。
- 静态评审，未执行任何脚本或测试；引脚校验与代码生成结果未经复现验证。
- 脚本本体与测试用例未在评审证据中可见，失败反馈质量未知。
- 技能内容仅英文，无中文支持；依赖 Claude Code 生态，中国大陆可达性未讨论。
- 发布者为未验证的个人账号，无 CHANGELOG 与明确维护承诺。
- 硬件安全建议（引脚限制、电流预算）应与乐鑫官方数据手册交叉核对后再用于实际电路。
这个 Skill 能做什么，适合哪些场景？
这是一个面向 Espressif ESP32 生态的 Claude Code 插件，覆盖 ESP-IDF 与 PlatformIO 两种开发框架。它内置 9 个芯片变体的参考文档、LVGL v8.2–v9.5 与 60 多块 Waveshare 开发板的引脚资料，并通过 Python 脚本对引脚分配做防烧砖校验（如 GPIO12 闪存电压陷阱、ADC2/Wi-Fi 冲突）。适合需要在生成固件代码的同时确保电气与启动安全的嵌入式开发者。
加载按需触发的参考文档（GPIO 数据库、各变体规格、协议速查、电气约束、LVGL、Waveshare 板卡）；运行 validate_pinmap.py 校验 JSON 引脚配置中的电气与启动冲突；运行 generate_config.py 生成 Arduino 或 ESP-IDF 初始化代码；输出引脚分配表、sdkconfig 片段与框架特定的初始化代码。
- 嵌入式开发者需要在 ESP32-S3 上同时接 BME280 传感器与 ST7789 显示屏并启用 Wi-Fi，希望提前发现 ADC2 冲突
- 初学者想为 ESP32-C6 生成 ESP-IDF 引脚初始化代码，避免手动配置错误
- 使用 Waveshare ESP32-S3 触摸 LCD 4.3 寸板的用户需要查引脚表
- 团队在 LVGL v8 迁移到 v9 时需要函数重命名对照与迁移指引
- 预算敏感的 IoT 节点选型者需要对比 C3/C6/H2 等变体的适用场景
这个 Skill 有哪些优点和局限？
- 内置具体的防烧砖校验：GPIO12 电压陷阱、闪存引脚保护、仅输入引脚、PSRAM 冲突、200mA 电流预算
- 覆盖 9 个芯片变体与 LVGL v8.2–v9.5、60+ Waveshare 板卡的结构化参考文档
- 附带 50 个自动化测试和可直接独立运行的 Python 校验/生成脚本
- 同时支持 Arduino 与 ESP-IDF 两种框架的代码生成
- 校验与代码生成仅支持 ESP32/S2/S3/C3/C6 五个变体；C2、C5、H2、P4 仅有参考文档，无脚本支持
- MIT 开源个人项目，未提供第三方认证或大规模生产环境使用证据
- 仅面向 Espressif 生态，不适用于其他 MCU 厂商
如何安装这个 Skill？
前提：已安装 Claude Code CLI 与 Python 3.9+。安装命令：claude /install-plugin https://github.com/ezrover/ESP32-AI-Agent-Skill，或先 git clone 该仓库后运行 claude /install-plugin ./ESP32-AI-Agent-Skill。
如何使用这个 Skill？
安装后在 Claude Code 中自然语言提问即可，例如：'I need to wire a BME280 sensor and ST7789 display to an ESP32-S3 with WiFi'。也可直接运行脚本：echo '{"platform":"esp32s3","pins":[{"gpio":21,"function":"I2C_SDA","protocol_bus":"i2c"}]}' | python scripts/validate_pinmap.py；代码生成用 python scripts/generate_config.py input. --framework arduino|espidf --format text。运行测试：python3 -m pytest tests/ -v。
这个 Skill 与同类方案有什么区别？
源材料未提及其他同类技能或竞品，无法给出可靠对比。