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:
parent
b7ee0f9885
commit
3e709577f5
@ -1,6 +1,6 @@
|
||||
# Claude Code 插件高效运用指南
|
||||
|
||||
> 更新日期: 2026-04-13(新增 GSD 执行框架 + 完善工具链全景)
|
||||
> 更新日期: 2026-05-19(新增 embed-ai-tool 3 个嵌入式专项 skill:serial-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-debug(FreeRTOS 任务/栈/死锁)、static-analysis(cppcheck/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 嵌入式专项 Skills(3 个)
|
||||
|
||||
这 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 执行框架
|
||||
|
||||
GSD(Get Shit Done)是防上下文腐烂的任务编排框架,安装后自动启用 context monitor hook:
|
||||
@ -743,6 +789,7 @@ idf.py --version # 应输出 ESP-IDF v5.4.2
|
||||
| 本指南文档 | Git 备份 | ❌ | clone 后自动生效 |
|
||||
| 插件代码(9 个插件) | 远程下载 | ✅ | 执行 `claude plugins install`(步骤 3) |
|
||||
| 第三方 Skills(7 个) | 远程下载 | ✅ | 执行 `npx skills add`(步骤 3.1) |
|
||||
| **embed-ai-tool 嵌入式专项 Skills(3 个)** | **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` |
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user