jzl-maker/ea-skill

🎯 为什么值得用

✨ 差异化亮点

• 🧭 需求澄清：描述不规范先提问坐实（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。

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

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

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

📦 命令总览（20 个）

✅ 真机验证

🔧 系统要求

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

MIT © 2026 jzl-maker

---

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