Skill
esp-dev-skill
rayheto/esp-dev-skill
48
InicialPluginScore · de 0 a 100ESP-IDF 嵌入式固件开发持续集成工具。帮助 Claude Code/Cursor Agent 自动处理设备探测、分区对比、环境验证、构建、烧录、监控等全流程脚本和规范指引。
Instalação
$
npx convez-ai rayheto/esp-dev-skill1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Estrelas
0Forks
0Acompanhando
0Saúde
42%Último commit
há 5 mesesVersão
—Issues abertas
0Contribuidores
1README
A tradução para o português deste README ainda está na fila.
esp-dev-skill
ESP-IDF 项目开发 Skill —— 把 Agent 的工作流统一编排到两套 MCP:
- 远程:Espressif Documentation MCP —— 查官方文档
- 本地:horw/esp-mcp —— build / flash / list_ports / pytest
不再自行实现 bash 工具链。MCP 没覆盖的少数缺口(monitor、OTA 定向烧 app、烧录前安全闸)由 scripts/*.py 薄封装补齐。
三段闭环
查文档 ──→ 改代码 ──→ 编译 → 烧录 → 监控验证
(Doc MCP) (Edit/Read) (horw MCP + python supplement)
每段对应 docs/ 下一份独立工作流文档,由 SKILL.md 根据用户意图路由。
安装
# 1) 把本仓库 clone 到 skills 目录
git clone https://github.com/woshinideba1425/esp-dev-skill ~/.claude/skills/esp-dev-skill
# 2) 安装 uv(如未装)
curl -LsSf https://astral.sh/uv/install.sh | sh
# 3) 一键配置本地 MCP(horw/esp-mcp)+ 引导远程 Doc MCP
cd ~/.claude/skills/esp-dev-skill
uv run python scripts/setup_mcp.py
# 4) 验证
uv run python scripts/mcp_doctor.py
setup_mcp.py 会:
- clone
horw/esp-mcp到~/tools/esp-mcp - 自动探测
IDF_PATH并写入~/.claude.json的mcpServers.esp-run - 引导你登录 mcp.espressif.com 启用 Documentation MCP(可选)
触发条件
Agent 检测到满足以下任一即加载:
| 判定 | 检测 |
|---|---|
| 构建产物 | build/project_description.json 存在 |
| CMake 入口 | CMakeLists.txt 含 include($ENV{IDF_PATH}/tools/cmake/project.cmake) |
| 组件项目 | 根目录有 idf_component.yml |
仓库布局
esp-dev-skill/
├── SKILL.md # 触发判定 + 意图路由(< 100 行)
├── docs/
│ ├── mcp_local.md # horw/esp-mcp 详解
│ ├── mcp_remote.md # Documentation MCP 详解
│ ├── workflow_query_docs.md # 工作流 A:查文档
│ ├── workflow_modify_code.md # 工作流 B:改代码
│ └── workflow_build_flash.md # 工作流 C:编译 → 烧 → 监控
├── scripts/
│ ├── setup_mcp.py # 一键安装与配置
│ ├── mcp_doctor.py # 健康检查
│ ├── port_safety_check.py # 烧录前安全闸(占用 + chip 一致性)
│ ├── flash_app_supplement.py # OTA-safe 定向烧 app
│ └── monitor_supplement.py # monitor + 崩溃分析(horw roadmap 加完即退役)
└── pyproject.toml # uv 项目
与官方 idf.py mcp-server(ESP-IDF v6.0+)
本 skill 默认接 horw/esp-mcp(不限 IDF 版本)。升级到 ESP-IDF v6.0 后可切换到官方 idf.py mcp-server,工作流文档与 supplement 脚本对二者均兼容。参见 docs/mcp_local.md。
兼容 Agent
Claude Code、Cursor、Codex CLI 等支持 MCP + Agent Skills 协议的运行时。
License
Apache-2.0