docs: 插件指南新增 GSD 执行框架章节 + GSD 项目参考文档
1、Claude Code 插件指南新增第九章:GSD 与工具链协作说明 - 任务规模自动匹配(小事直接做/中事 gsd-quick/大事 gsd-plan) - GSD 与 hw-driver-workflow 的分层协作关系 - GSD 常用命令速查表 - 防上下文腐烂覆盖范围说明 2、插件指南恢复指南新增步骤 3.2(GSD 安装命令) 3、新增 docs/Get Shit Done项目.html(GSD 项目介绍参考文档) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
parent
b35d86f84c
commit
7868efed9b
@ -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 安装后唯一"始终开启"的功能。
|
||||
|
||||
44465
docs/Get Shit Done项目.html
Normal file
44465
docs/Get Shit Done项目.html
Normal file
File diff suppressed because one or more lines are too long
Loading…
x
Reference in New Issue
Block a user