catalog/repos/adamlipecz--esp32-firmware-engineer-skill.md

ESP32固件工程Agent技能

ESP32 ESP-IDF 嵌入式 固件开发 Agent技能

esp32-firmware-engineer

一个面向 ESP32/ESP-IDF 固件工程的 Agent 技能。支持所有兼容 skills.sh 格式的 Agent，包括 Claude Code、Codex 等。

安装

npx skills add adamlipecz/esp32-firmware-engineer-skill --skill esp32-firmware-engineer

简介

• 专为 ESP32 固件工程（ESP-IDF）设计的 Agent 技能
• 聚焦于正确性、调试、硬件初始化、代码审查质量和可复现工作流
• 内置严格规则，涵盖硬件上下文、ESP32 精确型号识别、OTA、安全加固、LVGL 集成、分区配置、sdkconfig 及构建验证

技能强制执行的关键行为

• 在没有明确硬件上下文的情况下，不执行涉及硬件的任务
• 在没有确认 ESP32 精确型号的情况下，不继续操作
• 在构建/调试前，必须提供具体的框架兼容性证明（ESP-IDF / ESP-ADF / ESP-SR、LVGL 等）
• 优先使用可复现的配置方式（sdkconfig / 分区 CSV），而非临时菜单操作
• 运行构建脚本并验证通过后，方可声明任务完成
• 当 USB/串口空闲且策略允许时，主动添加服务终端
• 细节不明确时，要求提供示例代码或最小复现案例，而非凭空猜测

仓库结构

• SKILL.md — 面向 Agent 的技能说明与路由规则
• agents/openai.yaml — 兼容 OpenAI 的 Agent UI 元数据
• agents/claude.yaml — Claude Code UI 元数据
• references/ — 专题指导文档：
  • RTOS 模式、通信协议、内存优化、功耗优化
  • 微控制器编程、分区与 sdkconfig、日志与可观测性
  • 显示与图形、LVGL 集成、设备终端控制台
  • OTA 工作流、安全加固
  • 依赖兼容性、工具链与 Shell 配置、Panic 日志分析
  • ESP-IDF 检查清单、工程价值观
• scripts/ — 可复用的封装脚本（build.sh、flash.sh、monitor.sh 等）及兼容性预检工具
• assets/templates/ — 可复用模板（控制台、组件骨架、分区配置、Shell 片段、兼容性锁定示例）

验证

bash -n scripts/*.sh
python3 -m py_compile scripts/check_plugin_compatibility.py
git diff --check