⏳ This skill is pending AI review.

Scores will appear once the review pipeline completes.

v1.2.0

ea-skill

@jzl-maker⭐ 7 stars

嵌入式 AI 开发管家（EA-SKILL）— 面向单片机/嵌入式工程（Keil/CubeMX/ESP-IDF/PlatformIO/Arduino）的需求澄清与方案确认、新功能开发、单元测试、板级工装测试、编译烧录、J-Link 调试与验证。当用户要对嵌入式新老项目开发新功能、加外设、改业务逻辑、排查硬件 bug、验证固件、生成测试用例，或需求描述不清晰需要讨论确认方案、需要读取 PDF/Word/Excel 文档（芯片手册/需求规格/引脚表）时使用；对话提到编译/烧录/串口/RTT/断点/内存监视/需求分析/文档识别等嵌入式关键词时按需加载。

Choose how to use this skill

You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.

Adopt or update this skill from https://proskills.md/skills/other/jzl-maker-ea-skill. First identify the installation path supported by this platform, detect whether it is already installed, compare the installed version with the latest stable release, show me what will change, and only then install or update it. If no native installer is available, use the complete package or source fallback described on the page.

1. Native installer

This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.

Do not guess an installer command or replace an existing version without reviewing the diff.

2. Complete package recommended

Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.

No complete ProSkills package is published for this listing yet.

3. Prompt-only

Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.

Need only the instruction file?

Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.

No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.

—/10

// RATINGS

⭐GitHub Stars

⭐ 7 on GitHubGitHub ↗

New / niche

🟢ProSkills Score

—

📍

Not yet listed on ClawHub or SkillsMP

// README

EA-SKILL · 嵌入式 AI 开发管家

让 Claude Code 直接接管你的单片机 —— 编译、烧录、串口、调试、寄存器查询、示波器测量，全部一句话搞定。

输入 /ea new "给 LED 加 500ms 定时翻转"   →   自动完成 规划 → 编译 → 烧录 → 验证

[build]  Keil MDK 编译通过 ✅   (0 errors, 0 warnings)
[flash]  OpenOCD 烧录完成 ✅   (N32G4FR, 12.4s)
[scope]  CHAN1: 1.00kHz 方波, Vpp 3.08V, 50% 占空比 ✅   ← 真机实测
[svd]    RCC.CR = 0x0100XX00 → HSEON 已置位 ✅

测不准的时候，它不会硬给你一个数：

[scope]  ⚠️ 占空比在窗口内变化：逐周期 20.0% → 79.5%（极差 59.5 个百分点）
             上面报的 duty_pct=49.75% 只是整段窗口的均值      →  退出码 2

🎯 为什么值得用

痛点	EA-SKILL 解决
需求说不清楚，做完才发现理解偏了	`/ea new` 阶段 0 主动提问澄清（每题带推荐答案）→ 确认方案再动手
需求文档 / 引脚表 / 芯片手册得手抄进对话	`/ea doc` 直接解析 PDF / Word / Excel
编译烧录要在 Keil/OpenOCD 之间来回点	一句话 `/ea build flash`，AI 全程接管
查寄存器要翻 1500 页参考手册	`/ea svd` 免断点读值 + 位域/枚举自动解码
调变量要打断点 halt 住 CPU，中断就停	OpenOCD 免断点内存监控，运行中实时采样
看波形要手动抓示波器再导出分析	`/ea scope` 直接 SCPI 抓取 + 测量 + 出图
测出一个数，但不知道它可不可信	削顶/平线/不等周期/占空比在变一律标注 + 退出码 2，不静默给均值
固件超 Flash/RAM 了才知道	`/ea size` 编译即报占用率 + 超限预警

✨ 差异化亮点

🧭 需求澄清：描述不规范先提问坐实（9 维度扫描 + 带推荐答案的选择题），避免嵌入式返工（改引脚=改板）
📄 文档直读：PDF / Word / Excel 转 Markdown；DOCX/XLSX 零依赖，只有 PDF 需要装包
🔓 免断点调试：OpenOCD TCL 协议直接读内存，CPU 不 halt，中断/外设持续运行
📖 SVD 寄存器地图：自动发现 Keil Pack SVD，derivedFrom 继承展开，免查手册
🔬 仪器直连：Rigol 示波器（SCPI 抓取/测量）+ Saleae 逻辑分析仪 + 正点原子 DS100 CSV 解析
🎯 不给会误导判断的数：数据不可信时明说而不是硬报一个值——削顶/平线/噪声边沿/不等周期/占空比在窗口内变化，全部进 warnings 并置退出码 2，按 rc 分支就不会把"取到但不可信"当成成功
🧪 无硬件回归测试：199 条用例驱动全部工具脚本，合成数据 + 假可执行文件，不接任何仪器也能跑（tests/）
🧱 硬件红线保护：禁止 AI 改启动文件/链接脚本/中断向量表，需 /ea approve 显式授权
🛡️ AI 行为约束：增量修改默认给 diff，防 AI 整文件重写搞坏工程

🚀 快速上手

安装（一句话）： 在 Claude Code 或 Cline 等支持 Agent Skills 的客户端对话中，直接输入：

帮我安装 https://github.com/jzl-maker/EA-SKILL.git 的 skill

AI 会自动克隆仓库、安装到技能目录并初始化环境。然后接入你的工程：

/ea setup        # 环境/工具初始化（权限、工具路径、CLAUDE.md 触发器）
/ea si .          # 存量项目接入 → AI 生成上下文
/ea new "..."     # 说人话描述功能，AI 规划并开发

🔌 大模型适配

skill 的加载机制由宿主客户端提供，与模型本身解耦——DeepSeek 及任何 Anthropic 兼容端点的模型都能直接使用 EA-SKILL。

模型 × 客户端	支持	说明
Claude × Claude Code	✅ 开箱即用	原生 skill 机制
DeepSeek × Claude Code	✅	Claude Code 设置 `ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic`，`/ea setup` 全流程不变
DeepSeek × Cline	✅	Cline 配 DeepSeek 端点 + 安装到 `.claude/skills`，setup 微调（见下）
其他 Anthropic 兼容模型 × agent 客户端（Gemini CLI / Cursor）	✅	需客户端支持 Agent Skills，setup 微调
纯聊天客户端（Copilot Chat / Chatbox / 网页版）	❌	无「读文档 → 执行命令」的 agent 工具机制

✅ 已用 DeepSeek（deepseek-v4）真机跑通编译 / 烧录 / 示波器 / SVD 全流程。

换客户端时 setup 微调（skill 本体无需改动）：

权限：跳过 ~/.claude/settings.json 那步（Cline 等会自动弹权限确认），或换成该客户端的权限格式
触发器：改跑 py register_claude_md.py --target <该客户端记忆文件>（如 .cursor/rules / AGENTS.md），或手动写等效规则

📦 命令总览（20 个）

分类	命令
环境 / 项目	`/ea setup` `/ea init` `/ea si` `/ea rec`
开发 / 测试	`/ea new`（含需求澄清）`/ea doc`（PDF/Word/Excel）`/ea test`
构建 / 烧录	`/ea build` `/ea flash`
调试 / 寄存器	`/ea debug` `/ea svd`
仪器	`/ea la`（逻辑分析仪）`/ea scope`（示波器）
资源分析	`/ea size`（Flash/RAM/栈）`/ea map`（.map 解析）
验证 / 记录	`/ea verify` `/ea record` `/ea stat` `/ea help`

✅ 真机验证

能力	硬件	状态
烧录	ST-Link / DAP	✅
波形抓取/测量	Rigol DS1074Z / DS2302A	✅
深内存抓取（`--mode RAW`）	Rigol DS2302A（140 万点 @2 GSa/s）	✅
CSV 解析	正点原子 DS100	✅
SVD 寄存器地图	N32G4FR	✅
OpenOCD 免断点	ST-Link/DAP	⏳ 待实机
回归测试（无需硬件）	—	✅ 199 条全绿

🔧 系统要求

Windows 10/11 + Claude Code + Python 3.9+（py）+ Keil MDK + OpenOCD（J-Link / ST-Link 可选）

🧱 目录结构

EA-SKILL/
├── SKILL.md          # 入口（命令表 + 红线）
├── commands/         # 20 个命令文档（AI 按需读取，不污染上下文）
├── workflows/        # 验证四连 / HVR / 需求澄清 / 新功能流程
├── tools/            # build / flash / serial / debug / svd / instrument / doc-reader / resource ...
├── tests/            # 无硬件回归测试（199 条，见 tests/README.md）
└── mcp-servers/      # 串口 MCP

📄 License

Star 一下 ⭐，让嵌入式开发更 AI。

// HOW IT'S BUILT

KEY FILES

SKILL.mdREADME.md

// REPO STATS

7 stars

// SHARE

Share on X Share on LinkedIn