Skip to content
Back to search

embed-ai-tool

SkillWorks with Claude CodeGitHub

嵌入式开发技能集的总控入口。负责两类任务:(1) 用户请求安装本仓库 skill 时,引导选择全部或按需安装;(2) 用户发出模糊指令(如"烧录"、"编译"、"调试")且无法自动判断应使用哪个具体 skill 时,列出同分类下的候选 skill 供用户选择。

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/leokemp223--embed-ai-tool/badge.svg)](/listings/leokemp223--embed-ai-tool)

HTML

<a href="/listings/leokemp223--embed-ai-tool"><img src="/api/listings/leokemp223--embed-ai-tool/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

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.

SKILL.md · Manifest · 306 lines

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

  1. ---
  2. name: embed-ai-tool
  3. description: 嵌入式开发技能集的总控入口。负责两类任务:(1) 用户请求安装本仓库 skill 时,引导选择全部或按需安装;(2) 用户发出模糊指令(如"烧录"、"编译"、"调试")且无法自动判断应使用哪个具体 skill 时,列出同分类下的候选 skill 供用户选择。
  4. metadata:
  5. internal: true
  6. ---
  7. # embed-ai-tool 总控
  8. 本技能负责两类交互:**安装引导** 和 **指令消歧**。
  9. > **缓存复用提示**:所有 build/flash 脚本启动时会自动复用工程根目录 `.em_skill.json` 中上次成功的 profile 作为默认参数(显式参数优先,**无需 agent 先手动传 `--resume`**);`--resume` 仅用于断言缓存必须存在,无缓存则非零退出。新会话直接运行目标动作(`--build` / `--flash` 等)即可,缓存命中时参数自动补全。
  10. ---
  11. ## 一、安装引导
  12. 当用户请求安装本仓库的 skill 时,按以下流程引导。**不要跳过询问直接安装**,也不要替用户决定安装内容——先分析工程,再让用户选。
  13. ### 流程
  14. 1. **分析工程** — 探测当前工作区的工程特征(构建系统、工具链、探针、协议线索等),详见"工程分析项"
  15. 2. **呈现分析结果** — 把探测到的事实客观列给用户,未识别出的也要明确说明
  16. 3. **提供选项** — 基于分析结果给出可选安装方案(推荐集 / 全部 / 按分类 / 自定义),让用户选择,详见"提供的安装选项"
  17. 4. **执行安装** — 根据用户选择执行对应命令;用户可在推荐集基础上增删,不必重走流程
  18. ### 工程分析项
  19. 按工作区文件特征推断工程画像,规则优先级从高到低:
  20. | 类别 | 文件特征 | 推断结论 | 关联 skill |
  21. |------|----------|----------|-----------|
  22. | 构建系统 | `*.uvprojx` / `*.uvproj` | Keil MDK | `build-keil` `flash-keil` |
  23. | 构建系统 | `*.ewp` / `*.eww` | IAR EWARM | `build-iar` |
  24. | 构建系统 | `platformio.ini` | PlatformIO | `build-platformio` `flash-platformio` `debug-platformio` |
  25. | 构建系统 | `sdkconfig` + `components/` | ESP-IDF | `build-idf` `flash-idf` |
  26. | 构建系统 | `CMakeLists.txt` + `*.cmake` | CMake | `build-cmake` |
  27. | 构建系统 | `Makefile`(无 CMakeLists.txt) | Makefile | `build-makefile` |
  28. | 工具链 | PATH 含 `arm-none-eabi-gcc` | ARM Cortex-M 目标 | — |
  29. | 工具链 | PATH 含 `xtensa-esp32-elf-gcc` | ESP32 (Xtensa) 目标 | — |
  30. | 工具链 | PATH 含 `riscv64-unknown-elf-gcc` | RISC-V 目标 | — |
  31. | 调试器 | `.vscode/launch.json` 含 `openocd` | OpenOCD | `flash-openocd` `debug-gdb-openocd` |
  32. | 调试器 | `*.jlink` 文件或 JLinkExe 在 PATH | J-Link | `flash-jlink` `debug-jlink` |
  33. | 调试器 | `openocd.cfg` / `openocd.cfg.in` 存在 | OpenOCD 配置 | `flash-openocd` `debug-gdb-openocd` |
  34. | 协议 | 源码含 `#include "modbus.h"` 或 `mb.h` | 使用 Modbus | `modbus-debug` |
  35. | 协议 | 源码含 CAN HAL 驱动引用 | 使用 CAN 总线 | `can-debug` |
  36. | 协议 | `main.c` 引用 `stdio` / UART 重定向 | 使用串口日志 | `serial-monitor` |
  37. | 协议 | 源码含 `viOpen` / `viWrite` | 使用 SCPI 仪器 | `visa-debug` |
  38. | RTOS | 源码含 `FreeRTOS.h` / `rtthread.h` / `zephyr.h` | 使用 RTOS | `rtos-debug` |
  39. | 内存 | 工程能产出 `.map` / `.elf` | 可做内存分析 | `memory-analysis` |
  40. **探测失败时**:如果工作区特征不明显(纯裸 C 文件、混合工程、空目录),直接告知用户"未识别出明确工程类型",建议选"全部安装"或"自定义"——不要硬推推荐集。
  41. ### 推荐集映射
  42. 按识别到的工程画像给出基础推荐集(用户可在其上增删):
  43. | 工程类型 | 基础推荐集 |
  44. |---------|-----------|
  45. | Keil MDK | `build-keil` `flash-keil` `serial-monitor` `debug-gdb-openocd` `workflow` |
  46. | IAR EWARM | `build-iar` `flash-openocd` `serial-monitor` `workflow` |
  47. | PlatformIO | `build-platformio` `flash-platformio` `debug-platformio` `serial-monitor` `workflow` |
  48. | ESP-IDF | `build-idf` `flash-idf` `serial-monitor` `debug-gdb-openocd` `workflow` |
  49. | CMake | `build-cmake` `flash-openocd` `debug-gdb-openocd` `serial-monitor` `workflow` |
  50. | Makefile | `build-makefile` `flash-openocd` `serial-monitor` `workflow` |
  51. 基础集是起点,根据"工程分析项"探测到的协议线索继续追加:
  52. - 检测到 RTOS → 追加 `rtos-debug`
  53. - 检测到 Modbus → 追加 `modbus-debug`
  54. - 检测到 CAN → 追加 `can-debug`
  55. - 检测到 VISA / SCPI → 追加 `visa-debug`
  56. - 工程能产 `.map` / `.elf` → 追加 `memory-analysis`
  57. ### 提供的安装选项
  58. 分析完成后,向用户呈现 4 个并列选项:
  59. | 选项 | 说明 |
  60. |------|------|
  61. | **A. 推荐集** | 基于工程分析得出的最小集(通常 5-8 个),可在此基础上增删 |
  62. | **B. 全部安装** | 安装全部 24 个 skill,适合全局工具人 / 教学场景 |
  63. | **C. 按分类逐一勾选** | 按 6 个分类顺序逐一询问,每类下用户可全选、跳过或勾选部分(详见"分类逐一勾选流程") |
  64. | **D. 自定义** | 用户直接输入 skill 名或编号,自由组合 |
  65. 用户选 A 后仍可微调(如"再加个 modbus-debug"),不要重走一遍流程。
  66. ### 分类逐一勾选流程
  67. 用户选 C 后,按 6 个分类顺序逐一询问。每个分类独立交互,用户可全选、跳过或勾选部分。基于工程分析预先勾选推荐项,降低决策成本。
  68. **分类顺序与内容:**
  69. | 序号 | 分类 | 包含 skill(数量) | 默认勾选规则(基于工程分析) |
  70. |------|------|------------------|---------------------------|
  71. | 1 | 构建 | build-cmake / build-keil / build-iar / build-platformio / build-idf / build-makefile(6) | 勾选识别到的构建系统对应项,其余不勾 |
  72. | 2 | 烧录 | flash-keil / flash-openocd / flash-platformio / flash-idf / flash-jlink(5) | 勾选识别到的探针 / 工具链对应项 |
  73. | 3 | 调试 | debug-gdb-openocd / debug-jlink / debug-platformio / rtos-debug(4) | 勾选识别到的调试器对应项;检测到 RTOS 时勾 `rtos-debug` |
  74. | 4 | 通信 | serial-monitor / serial-shell / modbus-debug / can-debug / visa-debug / logic-analyzer(6) | 默认勾 `serial-monitor`;按协议线索勾 `modbus` / `can` / `visa` / `logic-analyzer` |
  75. | 5 | 分析 | memory-analysis / static-analysis(2) | 工程能产 `.map` / `.elf` 时勾 `memory-analysis` |
  76. | 6 | 编排 | workflow(1) | 默认勾选 |
  77. **单次分类询问格式:**
  78. ```
  79. [2/6] 烧录(5 个 skill):
  80. ✅ 1. flash-openocd — OpenOCD 烧录(识别到 .vscode/launch.json)
  81. ☐ 2. flash-keil — Keil MDK 烧录
  82. ☐ 3. flash-jlink — SEGGER J-Link 烧录
  83. ☐ 4. flash-platformio — PlatformIO 上传
  84. ☐ 5. flash-idf — ESP-IDF 串口烧录
  85. 操作:回车确认默认 / 输入编号增删(如 +3 -1)/ "全选" / "跳过"
  86. 👤 +3
  87. 🤖 [3/6] 调试(4 个 skill):
  88. ...
  89. ```
  90. **完成所有分类后**:汇总最终选定的 skill 列表,让用户确认或微调,然后执行安装。
  91. 如果用户对某个分类无任何勾选且工程分析也没识别到,应主动确认"跳过 X 分类?"避免遗漏关键能力(比如构建和烧录通常必须)。
  92. ### 安装示例
  93. ```
  94. 👤 帮我安装 embed-ai-tool 的 skill
  95. 🤖 正在分析当前工程...
  96. 检测到工程特征:
  97. • 构建系统:CMake(CMakeLists.txt)
  98. • 目标架构:ARM Cortex-M(PATH 含 arm-none-eabi-gcc)
  99. • 调试器配置:OpenOCD + ST-Link(.vscode/launch.json)
  100. • 协议线索:UART stdio 重定向(main.c)
  101. • RTOS:未检测到
  102. 可选安装方案:
  103. A. 推荐集(6 个)— build-cmake / flash-openocd / debug-gdb-openocd / serial-monitor / memory-analysis / workflow
  104. B. 全部安装(24 个)
  105. C. 按分类逐一勾选(6 个分类顺序询问)
  106. D. 自定义(输入 skill 名或编号)
  107. 请选择(A / B / C / D):
  108. 👤 A,再加个 rtos-debug
  109. 🤖 安装:build-cmake / flash-openocd / debug-gdb-openocd / serial-monitor / memory-analysis / workflow / rtos-debug
  110. 执行中...
  111. ```
  112. ### 可用技能列表
  113. > 完整技能清单,用于"按分类选(C)"和"自定义(D)"时参考。推荐集(A)的子集由"工程分析项"和"推荐集映射"自动推导。
  114. | 分类 | 技能 | 说明 |
  115. |------|------|------|
  116. | 构建 | `build-cmake` | 配置并构建基于 CMake 的 MCU 固件工程 |
  117. | 构建 | `build-keil` | 配置并构建基于 Keil MDK 的固件工程 |
  118. | 构建 | `build-iar` | 配置并构建基于 IAR EWARM 的固件工程 |
  119. | 构建 | `build-platformio` | 配置并构建基于 PlatformIO 的固件工程 |
  120. | 构建 | `build-idf` | 配置目标芯片并构建 ESP-IDF 固件工程 |
  121. | 构建 | `build-makefile` | 配置并构建基于 Makefile 的固件工程 |
  122. | 烧录 | `flash-keil` | 通过 Keil MDK 内置调试器烧录固件 |
  123. | 烧录 | `flash-openocd` | 通过 OpenOCD 烧录 ELF/HEX/BIN 产物 |
  124. | 烧录 | `flash-platformio` | 通过 PlatformIO 上传机制烧录固件 |
  125. | 烧录 | `flash-idf` | 通过 ESP-IDF 工具链烧录固件并支持 JTAG 调试 |
  126. | 烧录 | `flash-jlink` | 通过 SEGGER J-Link 烧录固件,支持 RTT 日志捕获 |
  127. | 调试 | `debug-gdb-openocd` | 通过 OpenOCD 附着 GDB 调试 |
  128. | 调试 | `debug-jlink` | 通过 J-Link GDB Server 在线调试和崩溃分析 |
  129. | 调试 | `debug-platformio` | 通过 PlatformIO 内置 GDB 调试 |
  130. | 调试 | `rtos-debug` | FreeRTOS/RT-Thread/Zephyr 线程感知调试 |
  131. | 通信 | `serial-monitor` | 串口选择与运行日志抓取 |
  132. | 通信 | `serial-shell` | 串口交互式 Shell 会话与批量脚本执行 |
  133. | 通信 | `modbus-debug` | Modbus RTU/TCP 寄存器读写与从站扫描 |
  134. | 通信 | `can-debug` | CAN 总线帧监听、发送和节点扫描 |
  135. | 通信 | `visa-debug` | VISA 仪器 SCPI 通信、波形捕获和截图 |
  136. | 通信 | `logic-analyzer` | Saleae 逻辑分析仪波形采集与 I2C/SPI/UART/CAN 解码 |
  137. | 分析 | `memory-analysis` | .map/ELF 内存使用报告与符号排名 |
  138. | 分析 | `static-analysis` | cppcheck/clang-tidy 静态分析,MISRA-C 合规 |
  139. | 编排 | `workflow` | 串联编译+烧录+监控/调试的流水线 |
  140. ### 安装命令
  141. 优先使用 `npx skills`,若用户无 Node.js 环境改用 Python 脚本。
  142. ```bash
  143. # npx 全部安装
  144. npx skills add LeoKemp223/embed-ai-tool -g -y
  145. # npx 按需安装
  146. npx skills add LeoKemp223/embed-ai-tool --skill build-cmake --skill flash-openocd -g -y
  147. # Python 全部安装
  148. python3 /tmp/embed-ai-tool/scripts/install.py /path/to/project
  149. # Python 按需安装
  150. python3 /tmp/embed-ai-tool/scripts/install.py /path/to/project --skills build-cmake flash-openocd
  151. ```
  152. ---
  153. ## 二、指令消歧
  154. 当用户发出模糊指令(如"烧录"、"编译"、"调试")时,先尝试自动探测工程类型;若无法明确判断,必须列出候选 skill 让用户选择,不要自行假设。
  155. ### 消歧流程
  156. ```
  157. 用户输入模糊指令
  158. │
  159. ▼
  160. 自动探测工程类型
  161. │
  162. ├─ 唯一匹配 → 直接调用对应 skill
  163. │
  164. └─ 匹配多个或无法判断 → 列出候选 skill 供用户选择
  165. ```
  166. ### 自动探测规则
  167. 按工作区文件特征判断工程类型,规则优先级从高到低:
  168. | 文件特征 | 工程类型 | 对应 skill |
  169. |----------|----------|-----------|
  170. | `*.uvprojx` / `*.uvproj` | Keil MDK | `build-keil` `flash-keil` |
  171. | `platformio.ini` | PlatformIO | `build-platformio` `flash-platformio` `debug-platformio` |
  172. | `sdkconfig` + `components/` | ESP-IDF | `build-idf` `flash-idf` |
  173. | `CMakeLists.txt` + `*.cmake` | CMake | `build-cmake` |
  174. | `Makefile` / `makefile`(无 CMakeLists.txt) | Makefile | `build-makefile` |
  175. | `.jlink` 文件或 JLinkExe 在 PATH | J-Link | `flash-jlink` `debug-jlink` |
  176. | `.vscode/launch.json` 含 `openocd` | OpenOCD | `flash-openocd` `debug-gdb-openocd` |
  177. | 以上均无 | 未知 | **必须询问用户** |
  178. ### 分类候选表
  179. 当自动探测无法唯一确定时,按用户指令所属分类展示候选 skill:
  180. **编译 / 构建:**
  181. | 技能 | 适用场景 |
  182. |------|----------|
  183. | `build-keil` | Keil MDK 工程(.uvprojx) |
  184. | `build-cmake` | CMake 工程(CMakeLists.txt) |
  185. | `build-iar` | IAR EWARM 工程(.ewp) |
  186. | `build-platformio` | PlatformIO 工程(platformio.ini) |
  187. | `build-idf` | ESP-IDF 工程(sdkconfig) |
  188. | `build-makefile` | 裸 Makefile 工程 |
  189. **烧录 / 下载:**
  190. | 技能 | 适用场景 |
  191. |------|----------|
  192. | `flash-keil` | Keil 工程 + 内置调试器(ST-Link / J-Link / CMSIS-DAP) |
  193. | `flash-openocd` | OpenOCD 兼容探针(ST-Link / CMSIS-DAP / DAPLink) |
  194. | `flash-jlink` | SEGGER J-Link 探针 |
  195. | `flash-platformio` | PlatformIO 上传(串口 / JTAG / DFU) |
  196. | `flash-idf` | ESP-IDF 工具链(ESP32 系列串口烧录) |
  197. **调试:**
  198. | 技能 | 适用场景 |
  199. |------|----------|
  200. | `debug-gdb-openocd` | OpenOCD + GDB 调试 |
  201. | `debug-jlink` | J-Link GDB Server 调试 |
  202. | `debug-platformio` | PlatformIO 内置 GDB |
  203. | `rtos-debug` | RTOS 线程感知调试(FreeRTOS / RT-Thread / Zephyr) |
  204. **通信 / 监控:**
  205. | 技能 | 适用场景 |
  206. |------|----------|
  207. | `serial-monitor` | 串口日志抓取 |
  208. | `modbus-debug` | Modbus RTU/TCP 通信 |
  209. | `can-debug` | CAN / CAN-FD 总线 |
  210. | `visa-debug` | SCPI 仪器通信 |
  211. ### 示例交互
  212. ```
  213. 👤 烧录
  214. 🤖 当前工作区未检测到明确的烧录工具配置,请选择:
  215. 1. flash-keil — Keil MDK 内置调试器烧录
  216. 2. flash-openocd — OpenOCD 烧录(ST-Link / CMSIS-DAP)
  217. 3. flash-jlink — SEGGER J-Link 烧录
  218. 4. flash-platformio — PlatformIO 上传
  219. 5. flash-idf — ESP-IDF 串口烧录
  220. 请输入编号或 skill 名称:
  221. 👤 2
  222. 🤖 使用 flash-openocd,正在探测探针和固件产物...
  223. ```
  224. ---
  225. ## 安装后提示
  226. 安装完成后,告知用户:
  227. - 已安装的 skill 列表
  228. - 使用 `/skill-name` 调用具体 skill,例如 `/build-cmake`、`/serial-monitor`
  229. - 用自然语言描述需求即可触发对应 skill,例如"编译烧录"、"看串口"
  230. - 管理命令:`npx skills ls -g`(查看)、`npx skills update -g`(更新)、`npx skills remove -g`(移除)
README.md · README · 138 lines

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

  1. [![English](https://img.shields.io/badge/lang-English-blue.svg)](README_EN.md)
  2. [![简体中文](https://img.shields.io/badge/lang-%E7%AE%80%E4%BD%93%E4%B8%AD%E6%96%87-red.svg)](README.md)
  3. # 打通AI开发硬件产品的研发、调试、测试全自动化流程。
  4. 面向 AI 编程助手的嵌入式开发技能集,为大模型提供 MCU 固件开发全流程能力。涵盖多工具链构建(Keil / IAR / CMake / PlatformIO / ESP-IDF / Makefile)、烧录(OpenOCD / J-Link / Keil 等)、GDB 调试、RTOS 线程感知调试、串口监视与 Shell 交互、Modbus / CAN / VISA 协议调试、逻辑分析仪、内存与静态分析及流水线编排,支持 Linux、macOS、Windows 三平台。
  5. <img width="1922" height="1091" alt="image" src="https://github.com/user-attachments/assets/6b23bfb1-8755-4f28-b510-abb7cc80d18f" />
  6. > **⚠ AI 助手请注意**:用户请求安装本仓库的 skill 时,必须先阅读 [INSTALL.md](INSTALL.md) 中的「给 AI 助手的安装协议」——先分析工程、呈现选项、等待用户确认后再安装,**严禁**直接全量复制 `skills/` 目录。
  7. ## 快速开始
  8. 在任意支持 skill 的大模型对话中输入:
  9. ```
  10. 帮我安装 https://github.com/LeoKemp223/embed-ai-tool.git 的 skill
  11. ```
  12. AI 助手会先分析你的工程类型(构建系统、调试器、协议线索),让你从推荐集 / 全部安装 / 按分类勾选 / 自定义中选,选完后才执行安装,避免污染工程目录。
  13. 其他安装方式(npx / Python 脚本 / 工具路径配置 / 更新与卸载)见 [INSTALL.md](INSTALL.md)。
  14. ## 技能列表
  15. 共 24 个 skill,按用途分为 6 类:
  16. | 分类 | 技能 | 说明 |
  17. |------|------|------|
  18. | 构建 | `build-cmake` | 配置并构建基于 CMake 的 MCU 固件工程 |
  19. | 构建 | `build-keil` | 配置并构建基于 Keil MDK 的固件工程 |
  20. | 构建 | `build-iar` | 配置并构建基于 IAR EWARM 的固件工程 |
  21. | 构建 | `build-platformio` | 配置并构建基于 PlatformIO 的固件工程 |
  22. | 构建 | `build-idf` | 配置目标芯片并构建 ESP-IDF 固件工程 |
  23. | 构建 | `build-makefile` | 编译基于裸 Makefile 的嵌入式固件工程 |
  24. | 烧录 | `flash-keil` | 通过 Keil MDK 内置调试器烧录固件 |
  25. | 烧录 | `flash-openocd` | 通过 OpenOCD 烧录 ELF/HEX/BIN 产物 |
  26. | 烧录 | `flash-platformio` | 通过 PlatformIO 上传机制烧录固件 |
  27. | 烧录 | `flash-idf` | 通过 ESP-IDF 工具链烧录固件并支持 JTAG 调试 |
  28. | 烧录 | `flash-jlink` | 通过 SEGGER J-Link 烧录固件,支持 RTT 日志捕获 |
  29. | 调试 | `debug-gdb-openocd` | 通过 OpenOCD 附着 GDB,支持下载后调试、仅附着和崩溃现场排查 |
  30. | 调试 | `debug-jlink` | 通过 J-Link GDB Server 进行固件在线调试和崩溃分析 |
  31. | 调试 | `debug-platformio` | 通过 PlatformIO 内置 GDB 调试 |
  32. | 调试 | `rtos-debug` | FreeRTOS/RT-Thread/Zephyr 线程感知调试,栈水位和死锁检测 |
  33. | 通信 | `serial-monitor` | 选择串口并抓取运行日志 |
  34. | 通信 | `serial-shell` | 通过串口建立交互式 Shell 会话,执行单条命令或批量脚本 |
  35. | 通信 | `modbus-debug` | Modbus RTU/TCP 寄存器读写、从站扫描和持续监控 |
  36. | 通信 | `can-debug` | CAN 总线帧监听、发送和节点扫描 |
  37. | 通信 | `visa-debug` | VISA 仪器 SCPI 通信、波形捕获和截图 |
  38. | 通信 | `logic-analyzer` | 用 Saleae 逻辑分析仪采集数字波形并解码 I2C/SPI/UART/CAN |
  39. | 分析 | `memory-analysis` | 解析 .map 文件或 ELF,生成内存使用报告和符号大小排名 |
  40. | 分析 | `static-analysis` | cppcheck/clang-tidy/GCC analyzer 静态分析,MISRA-C 合规 |
  41. | 编排 | `workflow` | 串联多个 skill 的流水线(编译+烧录+监控/调试) |
  42. ## 使用示例
  43. 安装 skill 后,在对话中用自然语言即可触发,也可以直接调用 skill 命令。
  44. ### 自然语言
  45. ```
  46. 👤 编译烧录
  47. 🤖 检测到 Keil 工程 Project.uvprojx,目标芯片 STM32F103C8。
  48. ✅ 编译成功,产物: build/Project.axf (48.2 KB)
  49. 检测到 ST-Link V2,烧录中...
  50. ✅ 烧录成功,已校验并复位。
  51. 👤 看串口
  52. 🤖 检测到 COM3 (115200),抓取日志:
  53. [00:00.000] System Start
  54. [00:00.012] UART initialized
  55. 👤 调试下 UART
  56. 🤖 已在 HAL_UART_Transmit 入口设置断点。
  57. 断点命中: huart->Init.BaudRate = 9600,与预期 115200 不符。
  58. 建议检查 UART 初始化代码中的波特率设置。
  59. ```
  60. ### Skill 命令
  61. ```bash
  62. # Keil 工程:编译 + 烧录 + 串口
  63. /build-keil
  64. /flash-keil
  65. /serial-monitor
  66. # CMake 工程:编译 + 烧录 + 调试
  67. /build-cmake
  68. /flash-openocd
  69. /debug-gdb-openocd
  70. # ESP-IDF 工程:编译 + 烧录
  71. /build-idf
  72. /flash-idf
  73. # 一键流水线(编译 → 烧录 → 监控)
  74. /workflow
  75. ```
  76. ## 仓库结构
  77. ```text
  78. .
  79. ├── skills/ # 24 个技能模块(每个含 SKILL.md + scripts + references)
  80. ├── shared/ # 共享约定(contracts / failure-taxonomy / platform-compatibility)
  81. │ # 与复用模块(project_detect.py / profile_store.py / tool_config.py)
  82. ├── templates/ # 新技能模板 skill-template/
  83. └── scripts/
  84. ├── install.py # 安装 / 卸载 / 状态检查
  85. ├── validate_repo.py # 仓库结构校验
  86. └── em_config.py # 工具路径配置 CLI
  87. ```
  88. <img width="2955" height="1955" alt="PixPin_2026-04-26_22-31-41" src="https://github.com/user-attachments/assets/e62e3118-929e-494c-8d24-c9dcebec22c3" />
  89. ## 共享约定
  90. 所有 skill 围绕同一套核心上下文进行输入与输出:
  91. - **Project Profile** — 工作区、目标、构建系统、探针和产物的标准化元数据
  92. - **Skill Handoff Contract** — 下游 skill 可直接继承的上下文
  93. - **Command Outcome Schema** — 成功、失败或阻塞结果的统一格式
  94. - **Failure Taxonomy** — 标准失败分类及推荐后续动作
  95. 详见 [shared/contracts.md](shared/contracts.md) 和 [shared/failure-taxonomy.md](shared/failure-taxonomy.md)。
  96. ## 贡献
  97. 参见 [CONTRIBUTING.md](CONTRIBUTING.md)(含技能结构要求和提交前校验流程)。新 skill 请基于 [templates/skill-template/](templates/skill-template/) 模板创建。
  98. ## 后续扩展
  99. 仓库结构已为后续扩展预留空间,例如 `flash-pyocd`、`vendor-tools`、`fault-triage`、`trace-analysis`,无需改动核心约定。
  100. 感谢 LinuxDo 社区的支持!
  101. [![LinuxDo](https://img.shields.io/badge/LinuxDo-社区支持-blue)](https://linux.do/)

Ratings and comments

Sign in to rate this skill.

Sign in

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