面向 AI 编程助手的嵌入式开发技能集，为大模型提供 MCU 固件开发全流程能力。涵盖多工具链构建（Keil / IAR / CMake / PlatformIO）、烧录、GDB 调试、串口监视、Shell 交互、Modbus / CAN / VISA 协议调试及流水线编排，支持 Linux、macOS、Windows 三平台。
当用户请求"安装 embed-ai-tool 的 skill"时，AI 助手（Claude Code / Cursor / Codex 等）必须遵循以下流程，严禁直接全量复制。
- 不要未经用户确认直接全量运行
install.py— 新版默认只分析不安装，需--skills X Y或--yes才会写入文件 - 不要用
cp -r/xcopy/Copy-Item/ 文件管理器全量复制skills/目录到目标工程 — 这会污染.claude/skills/ - 不要绕过
install.py用其他工具（PowerShell、FileExplorer、Robocopy 等）做等效全量复制
- 分析工程 — 在目标工程下运行
python3 scripts/install.py /path/to/project（不带安装参数），脚本输出工程类型探测结果 + 推荐集，不会写入任何文件 - 呈现给用户 — 把分析结果 + 4 个选项展示给用户：
- A. 推荐集（基于工程分析，通常 5-7 个）
- B. 全部安装（22 个，
--yes） - C. 按分类逐一勾选（6 个分类顺序询问）
- D. 自定义（直接输入 skill 名）
- 等待用户选择 — 用户明确选择后，再用
--skills X Y或--yes执行实际安装 - 汇报结果 — 安装完成后列出已装的 skill 清单
22 个 skill 涵盖 Keil / IAR / ESP-IDF / PlatformIO / CMake / Makefile 等多种工具链，单个工程通常只用其中 4-7 个。全量安装会污染 .claude/skills/ 目录、增加 Claude skill 列表的噪音、影响工程协作者。
在任意支持 skill 的大模型对话中输入：
帮我安装 https://github.com/LeoKemp223/embed-ai-tool.git 的 skill
AI 助手会先分析你的工程类型（构建系统、调试器、协议线索），然后让你从 4 个方案里选：
- A. 推荐集 — 基于工程分析得出，通常 5-7 个
- B. 全部安装 — 22 个，适合全局工具人
- C. 按分类逐一勾选 — 6 个分类顺序询问
- D. 自定义 — 直接输入 skill 名
你选完后才会执行安装，避免污染工程目录。详见上方的"给 AI 助手的安装协议"。
需要 Node.js 14+。使用 skills CLI 一键管理，支持 Claude Code、Cursor、Codex 等 50+ AI 编码助手。
npx skills add LeoKemp223/embed-ai-tool -g -ynpx skills add LeoKemp223/embed-ai-tool --skill build-cmake --skill flash-openocd -g -ynpx skills ls -g # 查看已安装
npx skills update -g # 更新
npx skills remove -g # 移除-g 表示全局安装（~/.claude/skills/），去掉则安装到当前项目（.claude/skills/）。
- Python 3.8+（无需第三方依赖）
- Git
git clone https://github.com/LeoKemp223/embed-ai-tool.git
python3 embed-ai-tool/scripts/install.py /path/to/your-project脚本会输出工程特征（构建系统、调试器、协议）和推荐安装的 skill 集，不会写入任何文件。
python3 embed-ai-tool/scripts/install.py /path/to/your-project --skills build-cmake flash-openocd debug-gdb-openocd serial-monitor workflowpython3 embed-ai-tool/scripts/install.py /path/to/your-project --yes⚠
--yes会复制全部 22 个 skill 到目标工程的.claude/skills/，仅推荐用于全局安装或工具人场景。
python3 embed-ai-tool/scripts/install.py /path/to/your-project --skills build-cmake flash-openocd serial-monitorcd embed-ai-tool && git pull
python3 scripts/install.py /path/to/your-project --force安装时附加 --detect，自动扫描 PATH 中的嵌入式工具并写入工作区配置：
python3 embed-ai-tool/scripts/install.py /path/to/your-project --detectpython3 embed-ai-tool/scripts/install.py /path/to/your-project --statuspython3 embed-ai-tool/scripts/install.py /path/to/your-project --uninstallpython3 embed-ai-tool/scripts/install.py --list部分 skill 依赖外部工具（OpenOCD、Keil、arm-none-eabi-gcc 等），除 --detect 外也可手动配置：
# 设置工具路径（工作区级别）
python3 scripts/em_config.py set openocd /usr/bin/openocd
# 设置全局工具路径
python3 scripts/em_config.py set uv4 "C:\Keil_v5\UV4\UV4.exe" --global
# 查看已配置的工具
python3 scripts/em_config.py list
# 查看配置文件位置
python3 scripts/em_config.py path| 技能 | 说明 |
|---|---|
build-cmake |
配置并构建基于 CMake 的 MCU 固件工程 |
build-keil |
配置并构建基于 Keil MDK 的固件工程 |
build-iar |
配置并构建基于 IAR EWARM 的固件工程 |
build-platformio |
配置并构建基于 PlatformIO 的固件工程 |
flash-keil |
通过 Keil MDK 内置调试器烧录固件 |
flash-openocd |
通过 OpenOCD 烧录 ELF/HEX/BIN 产物 |
flash-platformio |
通过 PlatformIO 上传机制烧录固件 |
debug-gdb-openocd |
通过 OpenOCD 附着 GDB，支持下载后调试、仅附着和崩溃现场排查 |
debug-platformio |
通过 PlatformIO 内置 GDB 调试 |
serial-monitor |
选择串口并抓取运行日志 |
modbus-debug |
Modbus RTU/TCP 寄存器读写、从站扫描和持续监控 |
can-debug |
CAN 总线帧监听、发送和节点扫描 |
visa-debug |
VISA 仪器 SCPI 通信、波形捕获和截图 |
workflow |
串联多个 skill 的流水线编排（编译+烧录+监控/调试） |
build-idf |
配置目标芯片并构建 ESP-IDF 固件工程 |
flash-idf |
通过 ESP-IDF 工具链烧录固件并支持 JTAG 调试 |
flash-jlink |
通过 SEGGER J-Link 烧录固件，支持 RTT 日志捕获 |
debug-jlink |
通过 J-Link GDB Server 进行固件在线调试和崩溃分析 |
memory-analysis |
解析 .map 文件或 ELF，生成内存使用报告和符号大小排名 |
rtos-debug |
FreeRTOS/RT-Thread/Zephyr 线程感知调试，栈水位和死锁检测 |
static-analysis |
cppcheck/clang-tidy/GCC analyzer 静态分析，MISRA-C 合规 |
安装 skill 后，在对话中用自然语言即可触发，也可以直接调用 skill 命令。
👤 编译烧录
🤖 检测到 Keil 工程 Project.uvprojx，目标芯片 STM32F103C8。
✅ 编译成功，产物: build/Project.axf (48.2 KB)
检测到 ST-Link V2，烧录中...
✅ 烧录成功，已校验并复位。
👤 看串口
🤖 检测到 COM3 (115200)，抓取日志：
[00:00.000] System Start
[00:00.012] UART initialized
👤 调试下 UART
🤖 已在 HAL_UART_Transmit 入口设置断点。
断点命中: huart->Init.BaudRate = 9600，与预期 115200 不符。
建议检查 UART 初始化代码中的波特率设置。
# Keil 工程：编译 + 烧录 + 串口
/build-keil
/flash-keil
/serial-monitor
# CMake 工程：编译 + 烧录 + 调试
/build-cmake
/flash-openocd
/debug-gdb-openocd
# ESP-IDF 工程：编译 + 烧录
/build-idf
/flash-idf
# 一键流水线（编译 → 烧录 → 监控）
/workflow.
├── skills/ # 技能模块
│ ├── build-cmake/ # CMake 构建
│ ├── build-keil/ # Keil 构建
│ ├── build-iar/ # IAR 构建
│ ├── build-platformio/ # PlatformIO 构建
│ ├── flash-keil/ # Keil 烧录
│ ├── flash-openocd/ # OpenOCD 烧录
│ ├── flash-platformio/ # PlatformIO 烧录
│ ├── debug-gdb-openocd/ # GDB 调试
│ ├── debug-platformio/ # PlatformIO 调试
│ ├── serial-monitor/ # 串口监视
│ ├── modbus-debug/ # Modbus 调试
│ ├── can-debug/ # CAN 总线调试
│ ├── visa-debug/ # VISA 仪器调试
│ ├── workflow/ # 流水线编排
│ ├── build-idf/ # ESP-IDF 构建
│ ├── flash-idf/ # ESP-IDF 烧录
│ ├── flash-jlink/ # J-Link 烧录
│ ├── debug-jlink/ # J-Link GDB 调试
│ ├── memory-analysis/ # 固件内存分析
│ ├── rtos-debug/ # RTOS 调试
│ └── static-analysis/ # 静态分析
├── shared/ # 共享约定
│ ├── contracts.md # 上下文交接合约
│ ├── failure-taxonomy.md # 失败分类
│ ├── platform-compatibility.md
│ ├── project_detect.py # 统一项目探测模块
│ └── references/
├── templates/ # Skill 模板
│ └── skill-template/
└── scripts/
├── install.py # 安装 / 卸载 / 状态检查
├── validate_repo.py # 结构校验
└── em_config.py # 工具路径配置 CLI
所有 skill 围绕同一套核心上下文进行输入与输出：
- Project Profile — 工作区、目标、构建系统、探针和产物的标准化元数据
- Skill Handoff Contract — 下游 skill 可直接继承的上下文
- Command Outcome Schema — 成功、失败或阻塞结果的统一格式
- Failure Taxonomy — 标准失败分类及推荐后续动作
详见 shared/contracts.md 和 shared/failure-taxonomy.md。
修改后执行结构校验：
python3 scripts/validate_repo.py校验器会检查所有 skill 必需文件、frontmatter 和章节标题是否齐全。
参见 CONTRIBUTING.md。新 skill 请基于 templates/skill-template/ 模板创建。
仓库结构已为后续扩展预留空间，例如 flash-pyocd、vendor-tools、fault-triage、trace-analysis，无需改动核心约定。
感谢 LinuxDo 社区的支持！
