diff --git a/Claude Code插件高效运用指南.md b/Claude Code插件高效运用指南.md index ea56006..f7fa29c 100644 --- a/Claude Code插件高效运用指南.md +++ b/Claude Code插件高效运用指南.md @@ -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//scripts/