ZE

zhinkgit/embeddedskills

Developer tools
550 stars Quality 42 Trend 42

嵌入式开发有一道纯软件开发没有的鸿沟:写完代码只是开始,编译、烧录、调试每一步都需要人在中间传递信息。

Overview

嵌入式开发有一道纯软件开发没有的鸿沟:写完代码只是开始,编译、烧录、调试每一步都需要人在中间传递信息。

README


✨ 三大核心优势

🔁 嵌入式 AI 工作流闭环

嵌入式开发有一道纯软件开发没有的鸿沟:写完代码只是开始,编译、烧录、调试每一步都需要人在中间传递信息。

AI 改完代码 → 手动编译 → 手动烧录 → 把报错复制给 AI → AI 再改 → 再编译……

embeddedskills 把这个循环交给 AI 自己跑:

flowchart TD
    A["💬 需求沟通"] --> B["✍️ 代码生成与优化"]
    B --> C["🔨 自动编译 keil build / gcc build"]
    C -->|有错误| D["🤖 AI 读取编译错误"]
    D --> B
    C -->|通过| E["⚡ 自动烧录 openоcd flash / jlink flash / probe-rs flash"]
    E --> F["🔬 自动调试验证"]
    F -->|异常| G["🤖 AI 读取调试信息"]
    G --> B
    F -->|正常| H["✅ 提交最终代码"]

    style A fill:#4CAF50,color:#fff
    style H fill:#4CAF50,color:#fff
    style C fill:#2196F3,color:#fff
    style E fill:#2196F3,color:#fff
    style F fill:#FF9800,color:#fff
    style D fill:#f44336,color:#fff
    style G fill:#f44336,color:#fff
环节 传统 AI 辅助 AI + embeddedskills
代码编写 AI 生成 AI 生成
编译构建 人工操作 ✅ AI 调用 Keil / GCC
烧录下载 人工操作 ✅ AI 调用 J-Link / OpenOCD
调试验证 人工操作 ✅ AI 断点 / 寄存器 / 内存
通信调试 人工操作 ✅ AI 串口 / CAN / 网络
错误修正 人工转述给 AI ✅ AI 读取并自主修正

🆓 完全免费,不限 AI 工具

本项目完全开源免费(MIT 协议)。只要 AI 工具支持 Skill / CLAUDE.md / Rules 协议,均可直接使用,包括但不限于:

  • Claude Code
  • OpenAI Codex CLI
  • TRAE
  • Cursor、Kiro、Windsurf 等其他支持 Skill 协议的工具

无需付费订阅任何附加服务,AI 工具自由切换。


⚡ 使用简单,无需迁移工程

直接在现有项目上使用,无需改动任何工程文件。 支持业界主流工程体系和调试器:

维度 支持范围
构建系统 Keil MDK 工程、CMake 工程
调试器 J-Link(SEGGER)、CMSIS-DAP / DAPLink
烧录框架 OpenOCD、probe-rs 兼容工具链
通信总线 串口(UART)、CAN / CAN-FD、以太网

一条命令安装,AI 即可自动识别工程类型并开始工作:

npx skills add https://github.com/zhinkgit/embeddedskills -g -y

Skill 一览

分类 Skill 能做什么 主要子命令
🔨 构建 keil Keil MDK 工程扫描、Target 枚举、编译、重建、清理 scan targets build rebuild clean flash
🔨 构建 gcc CMake 型 GCC 工程配置、编译、大小分析 scan presets configure build rebuild size
🔬 调试 jlink 烧录、读写内存/寄存器、RTT/SWO、GDB 调试 flash read-mem write-mem regs rtt swo + GDB
🔬 调试 openocd 烧录、擦除、GDB/Telnet、Semihosting/ITM flash erase reset gdb-server semihosting itm
🔬 调试 probe-rs 探针发现、烧录、复位、内存读写、GDB 调试、RTT list info flash erase reset read-mem write-mem gdb rtt
🔌 通信 serial 扫描串口、实时监控、发送数据、Hex 查看 scan monitor send hex log
🔌 通信 can CAN/CAN-FD 监控、发帧、DBC 解码、统计 scan monitor send decode stats
🔌 通信 net 抓包分析、连通性测试、端口扫描、流量统计 capture analyze ping scan stats
🔌 通信 ssh SSH 配置、远程命令、上传下载、跳板机和端口转发 list find show add + exec/transfer/tunnel
🔌 通信 terminal 串口、SSH、本地 Shell 双向交互会话 start send read attach stop
🎯 编排 workflow 自动识别工程 → 选择工具链 → 串联全流程 plan build build-flash build-debug observe diagnose

[!TIP] Keil / GCCJ-Link / OpenOCD / probe-rs 可自由正交组合,六种搭配均可开箱即用。


安装

方法一: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] → 完整安装与使用手册,包含截图演示和配置说明。


工作原理

三个关键设计让 AI 能真正自主闭环:

三层配置,按需覆盖,优先级从高到低:

CLI 参数  ──►  skill/config.json(工具路径、硬件参数)
          ──►  .embeddedskills/config.json(目标芯片、接口、日志目录)
          ──►  .embeddedskills/state.json(最近一次构建/烧录/调试记录)
          ──►  默认值

统一日志目录:

workspace/
└── .embeddedskills/
    ├── build/          ← 编译日志与 hex/bin 产物
    └── logs/
        ├── serial/     ← 串口监控日志
        ├── can/        ← CAN 报文日志
        └── net/        ← 网络抓包文件

外部依赖


完成进度

Skill 状态
keil ✅ 已完成测试
gcc ✅ 已完成测试
platformio 🔧 待支持
jlink ✅ 已完成测试
openocd ✅ 已完成测试
probe-rs ✅ 已完成测试
pyocd 🔧 待支持
serial ✅ 已完成测试
net ✅ 已完成测试
can 🔧 待测试
ssh ✅ 已完成测试
terminal 🔧 待硬件测试
workflow ✅ 已完成测试

Star History

欢迎提 Issue 和 PR。感谢 Linux.do 社区支持。

View this README on GitHub

Recommended Tools

Try a different keyword or remove a filter.

Install

npx skillfish add zhinkgit/embeddedskills