convez.ai
Skill
rayheto

esp-dev-skill

rayheto/esp-dev-skill

Ver no GitHub
InicialPluginScore · de 0 a 100

ESP-IDF 嵌入式固件开发持续集成工具。帮助 Claude Code/Cursor Agent 自动处理设备探测、分区对比、环境验证、构建、烧录、监控等全流程脚本和规范指引。

Instalação

$npx convez-ai rayheto/esp-dev-skill

1 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
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

README

A tradução para o português deste README ainda está na fila.

esp-dev-skill

ESP-IDF 项目开发 Skill —— 把 Agent 的工作流统一编排到两套 MCP:

不再自行实现 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

Ver o original no GitHub

Bom para

Relacionados