embeddedskills

简体中文 | English

embeddedskills — 嵌入式 AI 开发调试 Skill 集

让 AI 编码助手直接操控编译器、调试器和通信总线，实现从代码生成到硬件验证的完整闭环。

✨ 三大核心优势

🔁 嵌入式 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 工具

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

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

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

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

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

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

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

Skill 一览

[!TIP] Keil / GCC 与 J-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 能真正自主闭环：

{
  "status": "ok | error",
  "action": "build",
  "summary": "编译成功，0 errors，2 warnings",
  "details": { "warnings": ["unused variable 'x' at main.c:42"] },
  "artifacts": { "hex": ".embeddedskills/build/output.hex" },
  "next_actions": ["flash to device"]
}

三层配置，按需覆盖，优先级从高到低：

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

统一日志目录：

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

外部依赖

完成进度

Star History

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