diff --git a/Claude Code插件高效运用指南.md b/Claude Code插件高效运用指南.md index fd6e632..99d98b5 100644 --- a/Claude Code插件高效运用指南.md +++ b/Claude Code插件高效运用指南.md @@ -1,7 +1,7 @@ # Claude Code 插件高效运用指南 -> 更新日期: 2026-04-01（补充遗漏的内置 Skills 和命令） -> 适用环境: macOS / Claude Code 2.1.37+ / ESP32 嵌入式开发 +> 更新日期: 2026-04-13（新增 GSD 执行框架 + 完善工具链全景） +> 适用环境: macOS / Claude Code 2.1.79+ / ESP32 嵌入式开发 --- @@ -11,6 +11,7 @@ |------|------|------| | 官方插件 (claude-plugins-official) | 7 个 | Git 工作流、代码审查、功能开发、迭代循环、规则维护、Skill 创建 | | 社区插件 (claude-code-settings) | 2 个 | 长时任务自主执行、规格驱动开发 | +| **GSD 执行框架** | **68 个 Skills** | 防上下文腐烂、任务编排、context monitor、原子提交 | | 自定义 Skills (~/.claude/skills/) | 11 个 | ESP32 专用 6 个 + RK3588/Linux 驱动 4 个 + 硬件驱动工作流 1 个 | | 第三方 Skills (~/.claude/skills/) | 5 个 | find-skills、tmux、summarize、tavily-research、embedded-systems | | 内置 Skills | 6 个 | simplify、loop、claude-api、schedule、update-config、keybindings-help | @@ -692,6 +693,16 @@ npx skills add tavily-ai/skills@tavily-research -g -y npx skills add https://github.com/jeffallan/claude-skills --skill embedded-systems -g -y ``` +#### 步骤 3.2：安装 GSD 执行框架 + +GSD（Get Shit Done）是防上下文腐烂的任务编排框架，安装后自动启用 context monitor hook： + +```bash +npx get-shit-done-cc@latest --claude --global +``` + +安装后自动配置：68 个 Skills + context monitor hook + read-before-edit guard + prompt injection guard。 + #### 步骤 4：配置 API Key ```bash @@ -728,6 +739,89 @@ idf.py --version # 应输出 ESP-IDF v5.4.2 | 本指南文档 | Git 备份 | ❌ | clone 后自动生效 | | 插件代码（9 个插件） | 远程下载 | ✅ | 执行 `claude plugins install`（步骤 3） | | 第三方 Skills（5 个） | 远程下载 | ✅ | 执行 `npx skills add`（步骤 3.1） | +| 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` | | API Key | 手动配置 | ✅ | 写入环境变量 | + +--- + +## 九、GSD 执行框架与工具链协作 + +### 9.1 GSD 是什么 + +GSD（Get Shit Done）是一个防上下文腐烂的任务编排框架。它不替代你的 Skills 和插件，而是在**执行层**提供： +- **context monitor**：自动监控上下文窗口使用量，接近满时提醒处理 +- **任务原子化**：大任务拆成小任务，每个任务在独立上下文窗口执行 +- **持久化状态**：关键信息写入文件（PROJECT.md/STATE.md），不依赖对话记忆 +- **原子提交**：每个任务完成后自动 git commit，支持回滚 + +### 9.2 你不需要记任何命令 + +**直接描述需求即可**，Claude 会根据任务复杂度自动选择执行方式： + +| 任务规模 | Claude 的判断依据 | 执行方式 | Token 消耗 | +|---------|-----------------|---------|-----------| +| **小事** | 改动 1-2 个文件，几分钟搞定 | 直接做（或 /gsd-fast） | 低 | +| **中事** | 涉及 3-5 个文件，需要分析设计 | /gsd-quick | 中 | +| **大事** | 涉及 5+ 个文件，多阶段大任务 | /gsd-plan-phase + /gsd-execute-phase | 较高（但防腐烂） | + +**举例**： +- "帮我修复这个编译错误" → 直接做 +- "帮我写一个 I2C 温度传感器驱动" → 建议 /gsd-quick +- "把按键版的 6 个 Screen 迁移过来" → 建议 /gsd-plan-phase 拆分执行 + +如果你觉得 Claude 判断不准，可以直接说"用 quick 就行"或"这个比较大，拆开做"。 + +### 9.3 GSD 与 hw-driver-workflow 的协作关系 + +GSD 和 hw-driver-workflow 是**不同层**，不冲突： + +``` +┌─────────────────────────────────────────────────┐ +│ hw-driver-workflow（领域层） │ +│ 知道嵌入式该怎么开发：硬件分析→方案→编码→调试→沉淀 │ +│ + embedded-systems（通用嵌入式原则） │ +│ + esp-driver / linux-driver（平台 API 模板） │ +├─────────────────────────────────────────────────┤ +│ GSD（执行层） │ +│ 知道怎么拆任务、管上下文、防腐烂 │ +│ context monitor + 原子任务 + 独立上下文窗口 │ +└─────────────────────────────────────────────────┘ +``` + +**hw-driver-workflow 在什么时候被调用**： + +| 任务规模 | hw-driver-workflow 是否参与 | 说明 | +|---------|:---:|------| +| 小事（改 Bug） | 通常不触发 | 纯代码修改不需要硬件分析流程 | +| 中事（写驱动） | ✅ 触发 | 提供硬件分析→方案→编码的领域知识 | +| 大事（模块迁移） | ✅ 触发 | GSD 拆任务，每个子任务中 hw-driver-workflow 提供嵌入式知识 | + +**简单说**：GSD 管"怎么执行不腐烂"，hw-driver-workflow 管"嵌入式该怎么做"。 + +### 9.4 GSD 常用命令速查（按需使用） + +| 命令 | 说明 | 使用频率 | +|------|------|---------| +| `/gsd-fast` | 极轻量执行，零子 Agent 开销 | 高频 | +| `/gsd-quick` | 轻量任务，带原子提交和状态追踪 | 高频 | +| `/gsd-do 你的需求` | 自动路由到正确的 GSD 命令 | 高频 | +| `/gsd-plan-phase N` | 创建详细任务计划 | 大任务 | +| `/gsd-execute-phase N` | 按波次并行执行计划 | 大任务 | +| `/gsd-verify-work N` | 验证交付物 | 大任务 | +| `/gsd-new-project` | 初始化新项目 | 新项目 | +| `/gsd-map-codebase` | 分析现有代码库架构 | 接手项目 | +| `/gsd-help` | 查看所有可用命令 | 随时 | + +### 9.5 防上下文腐烂的覆盖范围 + +| 场景 | 是否防腐烂 | 机制 | +|------|:---:|------| +| 小任务直接对话 | ❌ | 对话短，不会腐烂，无需防护 | +| /gsd-fast | ⚠️ 部分 | context monitor 监控，但同一窗口 | +| /gsd-quick | ⚠️ 部分 | context monitor + 状态追踪 | +| /gsd-plan + execute | ✅ 完全 | 每个子任务独立 200K 上下文窗口 | +| GSD context monitor hook | ✅ 始终运行 | 任何对话中自动监控，接近满时提醒 | + +> **注意**：GSD 的 context monitor hook 在**所有对话中**自动运行（包括小任务），它不消耗额外 Token，只在上下文接近满时才介入提醒。这是 GSD 安装后唯一"始终开启"的功能。 diff --git a/docs/Get Shit Done项目.html b/docs/Get Shit Done项目.html new file mode 100644 index 0000000..2929631 --- /dev/null +++ b/docs/Get Shit Done项目.html @@ -0,0 +1,44465 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+
+ +
+
+ + + + + + +
+ +
+ +
+ + + +
+ +
+ cover_image +
+
+
+ + +
+
+ + + + + + + + + +
+ +

+5 天 5 万收藏的 GitHub 项目解决了 Claude Code 这个烦人问题。

+
+ + + + 逛逛 + + + + + 逛逛GitHub + +
+ + + + + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+ +
+ + + + +
+ +
+
+ +
+ + + +
+
+
+ +
+ + + +
+
+ + + + +
+
+ +
+
+
+ + + +
+ + + + +
+
+ + 继续滑动看下一个 +
+
+ +
+ + +
+ + + + + +
+
+
+ +
+ +
+
+
+
+
+
+
+
+
+ + + +
+
+
+
+ 逛逛GitHub
+
+
+
+
+
+
+
+ +
+
+
+
+
+
+
+
+
+
+
+ + 向上滑动看下一个 +
+
+
+
+ + + +
+ + +
+ + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +