Appearance
GSD (Get Shit Done) 使用手册
版本: v1.26.0 (2026-03-18) GitHub: https://github.com/gsd-build/get-shit-doneStars: ~36.4K ⭐ 作者: TÂCHES (glittercowboy) 协议: MIT 支持工具: Claude Code、OpenCode、Gemini CLI、Codex、Copilot、Antigravity
一、简介
GSD (Get Shit Done) 是一个轻量级但强大的元提示（meta-prompting）、上下文工程（context engineering）和规范驱动开发系统，专为 Claude Code 等编程助手设计。
核心卖点：解决"上下文腐烂"（Context Rot） — 随着 Claude 填满上下文窗口，输出质量会逐渐下降。GSD 通过结构化的上下文管理来解决这一问题。
一句话概括： 轻量但系统化，用"波次"（wave）管理上下文，适合个人开发者高效交付。
二、核心概念
2.1 上下文工程（Context Engineering）
GSD 的核心创新不是规范文件，而是上下文管理：
- 将大任务拆分成多个"波次"（wave）
- 每个波次有独立的上下文窗口
- 波次之间通过结构化文件传递信息
- 避免单次对话过长导致的"AI 失忆"
2.2 11 个专业 Agent
| Agent | 职责 |
|---|---|
| gsd-planner | 规划，生成实现计划 |
| gsd-plan-checker | 检查计划质量和完整性 |
| gsd-executor | 执行计划中的任务 |
| gsd-verifier | 验证实现是否符合规范 |
| gsd-phase-researcher | 阶段性研究 |
| 其他 Agent | 支持 research、docs、refactor 等专项任务 |
2.3 开发生命周期
DISCUSS（讨论）→ PLAN（规划）→ EXECUTE（执行）→ VERIFY（验证）→ MILESTONE（里程碑）三、安装
bash
# 方法一：npx（推荐）
npx gsd@latest init
# 方法二：npm 全局安装
npm install -g get-shit-done
# 初始化项目
cd your-project
gsd init支持多运行时：
- Claude Code
- OpenCode（社区适配版：gsd-opencode）
- Cursor IDE（社区适配版：gsd-for-cursor）
- Gemini CLI
- Codex
- Copilot
- Antigravity
四、核心命令（27 个斜杠命令）
4.1 项目初始化
/gsd:init # 初始化 GSD 项目结构
/gsd:status # 查看当前项目状态
/gsd:help # 查看所有命令4.2 阶段管理
/gsd:discuss # 进入讨论阶段
/gsd:plan # 进入规划阶段
/gsd:execute # 进入执行阶段
/gsd:verify # 进入验证阶段
/gsd:milestone # 标记里程碑完成4.3 上下文与波次
/gsd:continue # 继续当前工作（从上次中断处恢复）
/gsd:resume # 恢复之前的会话
/gsd:handoff # 生成跨会话交接文件（.sillyspec/HANDOFF.json）4.4 研究与规划
/gsd:research # 启动研究子代理
/gsd:design # 设计方案五、项目结构
your-project/
├── .gsd/ # GSD 配置
├── .sillyspec/ # 规划文件
│ ├── PLAN.md # 当前实现计划
│ ├── HANDOFF.json # 跨会话交接文件
│ ├── REQUIREMENTS.md # 需求文档
│ └── phases/ # 阶段性文件
├── docs/ # 项目文档
└── WAITING.json # 决策点信号文件（v1.26+）六、工作流详解
6.1 新项目启动
/gsd:init
→ 设置项目结构
→ 定义项目目标和技术栈6.2 DISCUSS 阶段
/gsd:discuss "我想做一个个人博客"
→ AI 提出澄清问题
→ 梳理需求边界
→ 生成 REQUIREMENTS.md6.3 PLAN 阶段
/gsd:plan
→ gsd-planner 生成实现计划
→ gsd-plan-checker 检查质量
→ 需求覆盖率验证（v1.26+）
→ 生成 PLAN.md6.4 EXECUTE 阶段
/gsd:execute
→ 按计划逐波次执行
→ 每波次独立上下文
→ 遇到决策点生成 WAITING.json
→ 支持交互式配对编程模式（v1.26+）6.5 VERIFY 阶段
/gsd:verify
→ gsd-verifier 验证实现
→ 对照原始需求检查
→ 生成验证报告6.6 MILESTONE
/gsd:milestone
→ 标记阶段完成
→ 归档当前波次
→ 准备下一轮迭代七、核心优势
7.1 解决上下文腐烂
普通方式：一个长对话 → 上下文越来越长 → AI 开始"失忆" GSD 方式：多个短波次 → 每次都有清晰的上下文 → 质量稳定
7.2 可恢复性
.sillyspec/HANDOFF.json保存会话状态- 随时可以中断和恢复
- 切换模型也不会丢失进度
7.3 需求追溯
- 从需求到代码的完整追溯链
- plan-phase 验证所有需求都被覆盖
- export spot checks（v1.26+）
八、与其他工具对比
| 维度 | GSD | Superpowers | OpenSpec |
|---|---|---|---|
| Stars | 36.4K | 99.6K | 32.5K |
| 核心创新 | 上下文工程 | TDD 纪律 | 变更管理 |
| 波次管理 | ✅ 核心 | ❌ | ❌ |
| TDD 强制 | ❌ | ✅ 严格 | ❌ |
| Agent 数量 | 11 个 | 6 个技能 | — |
| 上下文恢复 | ✅ HANDOFF.json | 部分 | ❌ |
| 复杂度 | 中 | 中 | 低 |
| Token 消耗 | 较高 | 较高 | 低 |
九、社区讨论（Hacker News 热帖）
GSD 最近登上 Hacker News（460 分、251 评论），社区反馈：
正面：
- "fire-and-forget 任务尤其好用，特别是涉及研究的任务"
- "框架很棒，适合自主开发"
负面/争议：
- "token 消耗是普通模式的 10 倍"
- "最终我发现 Plan mode 就够了"
- "这些框架适合不想手动引导 Claude 的人，但我更喜欢自己掌控"
十、最佳实践
- 适合自主开发：设置好需求后让 AI 跑几小时
- 注意 token 消耗：比普通对话多 5-10 倍
- 善用 handoff：长任务可以中断休息
- 简单任务别用：改个 typo 不需要走完整流程
- 多工具适配：支持 7+ 运行时，选你顺手的
十一、适配版本
| 版本 | Stars | 支持工具 |
|---|---|---|
| get-shit-done | 36.4K | Claude Code, OpenCode, Gemini CLI, Codex, Copilot |
| gsd-opencode | 529 | OpenCode（优化适配） |
| gsd-for-cursor | 60 | Cursor IDE |
十二、参考资料
- GitHub: https://github.com/gsd-build/get-shit-done
- DeepWiki: https://deepwiki.com/gsd-build/get-shit-done
- Hacker News 讨论: https://news.ycombinator.com/item?id=47417804
- Discord 社区: 见 GitHub README
- 版本记录: https://github.com/gsd-build/get-shit-done/releases
文档整理时间：2026-03-20 | 基于 GSD v1.26.0