Skip to content
Back to search

embeddedskills

SkillWorks with Claude CodeGitHub

An open-source collection of embedded development and debugging skills for Claude Code, Copilot, TRAE, and other AI coding assistants that support the Skill protocol. Once installed, the AI assistant can directly operate compilers, debuggers, and communication buses, automating the full workflow from code generation to hardware verification.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/zhinkgit--embeddedskills/badge.svg)](/listings/zhinkgit--embeddedskills)

HTML

<a href="/listings/zhinkgit--embeddedskills"><img src="/api/listings/zhinkgit--embeddedskills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

方法一:npx(推荐)

# 一键安装全部 skill
npx skills add https://github.com/zhinkgit/embeddedskills -g -y

# 只安装需要的 skill
npx skills add https://github.com/zhinkgit/embeddedskills --skill jlink -g -y

# 管理
npx skills ls -g        # 查看已安装
npx skills update -g    # 更新
npx skills remove -g    # 移除

方法二:直接 clone

# Claude Code(全局)
git clone https://github.com/zhinkgit/embeddedskills ~/.claude/skills/embeddedskills

# 仅当前项目
git clone https://github.com/zhinkgit/embeddedskills .claude/skills/embeddedskills

> [!NOTE] > **[→ 完整安装与使用手册](docs/getting-started.md)**,包含截图演示和配置说明。

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 265 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <div align="center">
  2. 简体中文 | [English](./README.en.md)
  3. # embeddedskills — 嵌入式 AI 开发调试 Skill 集
  4. **让 AI 编码助手直接操控编译器、调试器和通信总线,实现从代码生成到硬件验证的完整闭环。**
  5. [![MIT License](https://img.shields.io/badge/License-MIT-green?style=flat-square)](LICENSE)
  6. [![Status](https://img.shields.io/badge/status-active-success?style=flat-square)]()
  7. [![Stars](https://img.shields.io/github/stars/zhinkgit/embeddedskills?style=flat-square)](https://github.com/zhinkgit/embeddedskills/stargazers)
  8. [![CI](https://github.com/zhinkgit/embeddedskills/actions/workflows/ci.yml/badge.svg)](https://github.com/zhinkgit/embeddedskills/actions/workflows/ci.yml)
  9. [![Claude Code](https://img.shields.io/badge/Claude_Code-black?style=flat-square&logo=anthropic&logoColor=white)](https://claude.ai/code)
  10. [![OpenAI Codex CLI](https://img.shields.io/badge/OpenAI_Codex_CLI-412991?style=flat-square&logo=openai&logoColor=white)](https://github.com/openai/codex)
  11. [![TRAE](https://img.shields.io/badge/TRAE-0078D4?style=flat-square)](https://trae.ai)
  12. [![Cursor](https://img.shields.io/badge/Cursor-000?style=flat-square&logo=cursor&logoColor=white)](https://cursor.sh)
  13. [![Kiro](https://img.shields.io/badge/Kiro-232F3E?style=flat-square&logo=amazon&logoColor=white)](https://kiro.ai)
  14. </div>
  15. ---
  16. ## ✨ 三大核心优势
  17. ### 🔁 嵌入式 AI 工作流闭环
  18. 嵌入式开发有一道纯软件开发没有的鸿沟:写完代码只是开始,编译、烧录、调试每一步都需要人在中间传递信息。
  19. > AI 改完代码 → **你**手动编译 → **你**手动烧录 → **你**把报错复制给 AI → AI 再改 → **你**再编译……
  20. **embeddedskills 把这个循环交给 AI 自己跑:**
  21. ```mermaid
  22. flowchart TD
  23. A["💬 需求沟通"] --> B["✍️ 代码生成与优化"]
  24. B --> C["🔨 自动编译 keil build / gcc build"]
  25. C -->|有错误| D["🤖 AI 读取编译错误"]
  26. D --> B
  27. C -->|通过| E["⚡ 自动烧录 openоcd flash / jlink flash / probe-rs flash"]
  28. E --> F["🔬 自动调试验证"]
  29. F -->|异常| G["🤖 AI 读取调试信息"]
  30. G --> B
  31. F -->|正常| H["✅ 提交最终代码"]
  32. style A fill:#4CAF50,color:#fff
  33. style H fill:#4CAF50,color:#fff
  34. style C fill:#2196F3,color:#fff
  35. style E fill:#2196F3,color:#fff
  36. style F fill:#FF9800,color:#fff
  37. style D fill:#f44336,color:#fff
  38. style G fill:#f44336,color:#fff
  39. ```
  40. | 环节 | 传统 AI 辅助 | AI + embeddedskills |
  41. |------|------------|-------------------|
  42. | 代码编写 | AI 生成 | AI 生成 |
  43. | 编译构建 | **人工操作** | ✅ AI 调用 Keil / GCC |
  44. | 烧录下载 | **人工操作** | ✅ AI 调用 J-Link / OpenOCD |
  45. | 调试验证 | **人工操作** | ✅ AI 断点 / 寄存器 / 内存 |
  46. | 通信调试 | **人工操作** | ✅ AI 串口 / CAN / 网络 |
  47. | 错误修正 | **人工转述给 AI** | ✅ AI 读取并自主修正 |
  48. ---
  49. ### 🆓 完全免费,不限 AI 工具
  50. 本项目完全开源免费(MIT 协议)。只要 AI 工具支持 Skill / CLAUDE.md / Rules 协议,均可直接使用,包括但不限于:
  51. - **Claude Code**
  52. - **OpenAI Codex CLI**
  53. - **TRAE**
  54. - **Cursor、Kiro、Windsurf** 等其他支持 Skill 协议的工具
  55. 无需付费订阅任何附加服务,AI 工具自由切换。
  56. ---
  57. ### ⚡ 使用简单,无需迁移工程
  58. **直接在现有项目上使用,无需改动任何工程文件。** 支持业界主流工程体系和调试器:
  59. | 维度 | 支持范围 |
  60. |------|---------|
  61. | **构建系统** | Keil MDK 工程、CMake 工程 |
  62. | **调试器** | J-Link(SEGGER)、CMSIS-DAP / DAPLink |
  63. | **烧录框架** | OpenOCD、probe-rs 兼容工具链 |
  64. | **通信总线** | 串口(UART)、CAN / CAN-FD、以太网 |
  65. 一条命令安装,AI 即可自动识别工程类型并开始工作:
  66. ```bash
  67. npx skills add https://github.com/zhinkgit/embeddedskills -g -y
  68. ```
  69. ---
  70. ## Skill 一览
  71. | 分类 | Skill | 能做什么 | 主要子命令 |
  72. |:---:|:---:|---|---|
  73. | 🔨 构建 | **keil** | Keil MDK 工程扫描、Target 枚举、编译、重建、清理 | `scan` `targets` `build` `rebuild` `clean` `flash` |
  74. | 🔨 构建 | **gcc** | CMake 型 GCC 工程配置、编译、大小分析 | `scan` `presets` `configure` `build` `rebuild` `size` |
  75. | 🔨 构建 | **eide** | EIDE 工程扫描、配置枚举、构建和大小分析 | `scan` `configs` `build` `rebuild` `clean` `size` |
  76. | 🔬 调试 | **jlink** | 烧录、读写内存/寄存器、RTT/SWO、GDB 调试 | `flash` `read-mem` `write-mem` `regs` `rtt` `swo` + GDB |
  77. | 🔬 调试 | **openocd** | 烧录、擦除、GDB/Telnet、Semihosting/ITM | `flash` `erase` `reset` `gdb-server` `semihosting` `itm` |
  78. | 🔬 调试 | **probe-rs** | 探针发现、烧录、复位、内存读写、GDB 调试、RTT | `list` `info` `flash` `erase` `reset` `read-mem` `write-mem` `gdb` `rtt` |
  79. | 🔌 通信 | **serial** | 扫描串口、实时监控、发送数据、Hex 查看 | `scan` `monitor` `send` `hex` `log` `mux` |
  80. | 🔌 通信 | **can** | CAN/CAN-FD 监控、发帧、DBC 解码、统计 | `scan` `monitor` `send` `decode` `stats` |
  81. | 🔌 通信 | **net** | 抓包分析、连通性测试、端口扫描、流量统计 | `capture` `analyze` `ping` `scan` `stats` |
  82. | 🔌 通信 | **terminal** | Agent 终端,内置 SSH、串口和本地进程 | `exec` `start` `send` `read` `serial` `ssh` |
  83. | 🎯 规划 | **workflow** | 只读工程发现、命令规划和诊断 | `plan` `diagnose` |
  84. > [!TIP]
  85. > `Keil / GCC` 与 `J-Link / OpenOCD / probe-rs` 可自由正交组合,六种搭配均可开箱即用。
  86. ---
  87. ## 安装
  88. ### 方法一:npx(推荐)
  89. ```bash
  90. # 一键安装全部 skill
  91. npx skills add https://github.com/zhinkgit/embeddedskills -g -y
  92. # 只安装需要的 skill
  93. npx skills add https://github.com/zhinkgit/embeddedskills --skill jlink -g -y
  94. # 管理
  95. npx skills ls -g # 查看已安装
  96. npx skills update -g # 更新
  97. npx skills remove -g # 移除
  98. ```
  99. ### 方法二:直接 clone
  100. ```bash
  101. # Claude Code(全局)
  102. git clone https://github.com/zhinkgit/embeddedskills `/.claude/skills/embeddedskills
  103. # 仅当前项目
  104. git clone https://github.com/zhinkgit/embeddedskills .claude/skills/embeddedskills
  105. ```
  106. > [!NOTE]
  107. > **[→ 完整安装与使用手册](docs/getting-started.md)**,包含截图演示和配置说明。
  108. ---
  109. ## 工作原理
  110. 三个关键设计让 AI 能真正自主闭环:
  111. <details>
  112. <summary><b>① 封装命令行工具</b></summary>
  113. 每个 Skill 是一组 Python 脚本,将底层工具(UV4.exe、cmake、JLink.exe、openocd、probe-rs、tshark 等)的命令行参数和交互流程转化为结构化子命令,AI 可以像调用函数一样调用这些工具。
  114. </details>
  115. <details>
  116. <summary><b>② 通过 SKILL.md 暴露给 AI</b></summary>
  117. 每个 Skill 目录下的 `SKILL.md` 以自然语言描述能力、子命令和使用场景。AI 读取后即可正确调用,**无需额外训练或配置**,任何支持 Skill 协议的 AI 工具开箱即用。
  118. </details>
  119. <details>
  120. <summary><b>③ 统一 JSON 输出,驱动下一步决策</b></summary>
  121. 可自动化命令使用 --json 返回统一结构的 JSON,AI 直接解析状态、摘要和建议,自主决定下一步操作:
  122. ```json
  123. {
  124. "status": "ok | error",
  125. "action": "build",
  126. "summary": "编译成功,0 errors,2 warnings",
  127. "details": { "warnings": ["unused variable 'x' at main.c:42"] },
  128. "artifacts": { "hex": ".embeddedskills/build/output.hex" },
  129. "next_actions": ["flash to device"]
  130. }
  131. ```
  132. </details>
  133. <br>
  134. **配置来源与解析顺序**
  135. ```
  136. 工具路径 CLI → skill/config.json → PATH
  137. 工程参数 CLI → .embeddedskills/config.json → .embeddedskills/state/<skill>.json → 发现或默认值
  138. ```
  139. **统一日志目录:**
  140. ```
  141. workspace/
  142. └── .embeddedskills/
  143. ├── build/ ← 编译日志与 hex/bin 产物
  144. └── logs/
  145. ├── serial/ ← 串口监控日志
  146. ├── can/ ← CAN 报文日志
  147. └── net/ ← 网络抓包文件
  148. ```
  149. ---
  150. ## 外部依赖
  151. <details>
  152. <summary>展开查看各 Skill 所需依赖</summary>
  153. | Skill | 依赖 |
  154. |---|---|
  155. | keil | Keil MDK (UV4.exe) |
  156. | gcc | CMake · Ninja/Make · ARM GNU Toolchain |
  157. | jlink | SEGGER J-Link Software · arm-none-eabi-gdb |
  158. | openocd | OpenOCD · 调试器驱动 (ST-Link / CMSIS-DAP / DAPLink / FTDI) |
  159. | probe-rs | probe-rs CLI · arm-none-eabi-gdb |
  160. | serial | pyserial · USB 转串口驱动 |
  161. | can | python-can · cantools · pyserial · USB-CAN 驱动 |
  162. | net | Wireshark (tshark) · Npcap |
  163. | terminal | pyserial(串口后端)· OpenSSH 客户端(SSH 后端) |
  164. > 除 CAN、串口和 terminal 的串口后端外,所有 Skill 均基于 Python 标准库实现,无需额外安装 Python 依赖。
  165. > [!WARNING]
  166. > Windows 下若要让 `probe-rs` 驱动 `J-Link`,通常需要把驱动切到 `WinUSB`,这会影响 SEGGER 官方工具继续使用。若你仍依赖 J-Link 官方工具链,优先继续使用现有 `jlink` skill。
  167. </details>
  168. ---
  169. ## 完成进度
  170. | Skill | 状态 |
  171. |---|:---:|
  172. | keil | ✅ 已完成测试 |
  173. | gcc | ✅ 已完成测试 |
  174. | platformio | 🔧 待支持 |
  175. | jlink | ✅ 已完成测试 |
  176. | openocd | ✅ 已完成测试 |
  177. | probe-rs | ✅ 已完成测试 |
  178. | pyocd | 🔧 待支持 |
  179. | serial | ✅ 已完成测试 |
  180. | net | ✅ 已完成测试 |
  181. | can | 🔧 待测试 |
  182. | terminal | 🔧 待硬件测试 |
  183. | workflow | ✅ 已完成测试 |
  184. ---
  185. ## Star History
  186. <a href="https://star-history.dera.page/#zhinkgit/embeddedskills&type=date&legend=top-left">
  187. <picture>
  188. <source media="(prefers-color-scheme: dark)" srcset="https://star-history.dera.page/svg?repos=zhinkgit/embeddedskills&type=date&theme=dark&legend=top-left" />
  189. <source media="(prefers-color-scheme: light)" srcset="https://star-history.dera.page/svg?repos=zhinkgit/embeddedskills&type=date&legend=top-left" />
  190. <img alt="Star History Chart" src="https://star-history.dera.page/svg?repos=zhinkgit/embeddedskills&type=date&legend=top-left" />
  191. </picture>
  192. </a>
  193. 欢迎提 Issue 和 PR。感谢 [Linux.do](https://linux.do/) 社区支持。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.