52 lines
2.2 KiB
Markdown
52 lines
2.2 KiB
Markdown
# 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
|
||
``` |