docs: 更新 Claude Code 插件高效运用指南 (加 embed-ai-tool 3 个嵌入式 skill)

补充内容:
- 一、资源总览: 新增 "embed-ai-tool 嵌入式专项 Skills (3 个)" 行
- 五、自动触发表: 加 serial-monitor / rtos-debug / static-analysis 触发关键词
- 五、协同表: 加 embed-ai-tool 与插件配合的工作流
- 八、新电脑环境恢复指南:
  * 新增步骤 3.1.5 安装 embed-ai-tool 3 个 skill (git clone + cp)
  * 8.3 恢复内容清单新增 embed-ai-tool 行
  * 可选依赖工具说明 (pyserial / cppcheck / llvm)

3 个 skill 用途:
- serial-monitor: 串口抓包/日志分析 (避免手动复制粘贴日志)
- rtos-debug: FreeRTOS 任务/栈/死锁分析
- static-analysis: cppcheck/clang-tidy/MISRA-C 静态扫描

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
Rdzleo 2026-05-20 18:17:54 +08:00
parent b7ee0f9885
commit 3e709577f5

View File

@ -1,6 +1,6 @@
# Claude Code 插件高效运用指南
> 更新日期: 2026-04-13新增 GSD 执行框架 + 完善工具链全景
> 更新日期: 2026-05-19新增 embed-ai-tool 3 个嵌入式专项 skillserial-monitor / rtos-debug / static-analysis
> 适用环境: macOS / Claude Code 2.1.79+ / ESP32 嵌入式开发
---
@ -14,6 +14,7 @@
| **GSD 执行框架** | **68 个 Skills** | 防上下文腐烂、任务编排、context monitor、原子提交 |
| 自定义 Skills (~/.claude/skills/) | 11 个 | ESP32 专用 6 个 + RK3588/Linux 驱动 4 个 + 硬件驱动工作流 1 个 |
| 第三方 Skills (~/.claude/skills/) | 7 个 | find-skills、tmux、summarize、tavily-research、embedded-systems、think、health |
| **embed-ai-tool 嵌入式专项 Skills** | **3 个** | serial-monitor串口抓包/日志分析、rtos-debugFreeRTOS 任务/栈/死锁、static-analysiscppcheck/clang-tidy/MISRA-C |
| 内置 Skills | 6 个 | simplify、loop、claude-api、schedule、update-config、keybindings-help |
---
@ -567,6 +568,9 @@ allowed-tools: Bash, Read, Grep, Glob # 可选,限制可用工具
| **embedded-systems** | 涉及固件开发、RTOS、中断处理、DMA、功耗优化、裸机编程、volatile 声明等通用嵌入式工程原则 |
| **think** | 新功能、架构决策前。质疑需求、压力测试设计、提供 2-3 方案对比(不用于小 Bug 修复) |
| **health** | Claude 行为异常、hooks 失效、Skills 配置冲突时。审计六层配置栈,按严重程度分级报告 |
| **serial-monitor** | 说"抓串口"、"看串口日志"、"识别串口"、需要监控 UART 启动日志或断言输出 |
| **rtos-debug** | 说"FreeRTOS 任务"、"栈水位"、"死锁"、"线程感知调试"、`pxCurrentTCB``uxTaskGetSystemState` |
| **static-analysis** | 说"静态分析"、"cppcheck"、"clang-tidy"、"MISRA-C"、提交前缺陷扫描 |
### ESP32 Skills 与插件配合
@ -579,6 +583,14 @@ allowed-tools: Bash, Read, Grep, Glob # 可选,限制可用工具
| esp-code-review | "帮我审查代码" | 先 esp-code-review → 再 `/review-pr` 双重审查 |
| esp-driver | "写一个I2C驱动" | `/feature-dev` 设计 → esp-driver 生成 → `/code-review` 审查 |
### embed-ai-tool 嵌入式专项 Skills 与插件配合
| Skill | 触发方式 | 与插件配合 |
|-------|---------|-----------|
| **serial-monitor** | "抓串口" / "看启动日志" / "识别 ESP32 串口" | serial-monitor 抓日志 → esp-analyze-log 解析 → `/revise-claude-md` 记录 |
| **rtos-debug** | "FreeRTOS 任务栈不够" / "死锁分析" / "看 pxCurrentTCB" | rtos-debug 分析任务/栈/优先级 → esp-troubleshoot 排障 → `/commit` 记录修复 |
| **static-analysis** | "提交前静态扫描" / "cppcheck 一下" / "MISRA-C 检查" | static-analysis 扫描 → esp-code-review 二次审查 → `/commit-push-pr` 发布 |
### RK3588/Linux 驱动 Skills 与插件配合
| 自定义 Skill | 触发方式 | 与插件配合 |
@ -697,6 +709,40 @@ npx skills add tw93/Waza@think -g -y
npx skills add tw93/Waza@health -g -y
```
#### 步骤 3.1.5:安装 embed-ai-tool 嵌入式专项 Skills3 个)
这 3 个 skill 是手动从 GitHub 仓库 `LeoKemp223/embed-ai-tool` 复制的,不通过 `npx skills add`
```bash
# 临时 clone
cd /tmp && git clone --depth 1 https://github.com/LeoKemp223/embed-ai-tool.git
# 复制 3 个 skill 到 ~/.claude/skills/
cp -r /tmp/embed-ai-tool/skills/serial-monitor ~/.claude/skills/
cp -r /tmp/embed-ai-tool/skills/rtos-debug ~/.claude/skills/
cp -r /tmp/embed-ai-tool/skills/static-analysis ~/.claude/skills/
# 复制 shared 公共模块 (rtos-debug / static-analysis 依赖 tool_config.py 等)
mkdir -p ~/.claude/skills/shared
cp /tmp/embed-ai-tool/shared/*.py ~/.claude/skills/shared/
cp /tmp/embed-ai-tool/shared/platform-compatibility.md ~/.claude/skills/shared/
# 清理
rm -rf /tmp/embed-ai-tool
```
**可选:安装这 3 个 skill 依赖的外部工具**(用到才装,不强制):
```bash
# serial-monitor 依赖
pip3 install pyserial
# static-analysis 依赖
brew install cppcheck llvm # llvm 自带 clang-tidy
```
> **注意**:脚本调用走 `python3 ~/.claude/skills/<skill>/scripts/<script>.py`,依赖未装时 skill 会提示安装命令。
#### 步骤 3.2:安装 GSD 执行框架
GSDGet Shit Done是防上下文腐烂的任务编排框架安装后自动启用 context monitor hook
@ -743,6 +789,7 @@ idf.py --version # 应输出 ESP-IDF v5.4.2
| 本指南文档 | Git 备份 | ❌ | clone 后自动生效 |
| 插件代码9 个插件) | 远程下载 | ✅ | 执行 `claude plugins install`(步骤 3 |
| 第三方 Skills7 个) | 远程下载 | ✅ | 执行 `npx skills add`(步骤 3.1 |
| **embed-ai-tool 嵌入式专项 Skills3 个)** | **GitHub clone** | **✅** | **执行 `git clone + cp`(步骤 3.1.5** |
| GSD 执行框架68 个 Skills | 远程下载 | ✅ | 执行 `npx get-shit-done-cc@latest`(步骤 3.2 |
| Claude Code 程序 | npm 远程 | ✅ | 执行 `npm install -g` |
| ESP-IDF v5.4.2 | GitHub | ✅ | 执行 `git clone` + `install.sh` |