# ESP32固件工程Agent技能

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

# esp32-firmware-engineer

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

## 安装

```bash
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
bash -n scripts/*.sh
python3 -m py_compile scripts/check_plugin_compatibility.py
git diff --check
```