1. 一句话定义

GSD（Get Shit Done） 是一个专为马拉松式长期项目设计的编排框架。它专治"上下文腐烂"——不给你加技能，而是给你一套工作流协议：把项目拆成多个阶段，每个阶段开全新上下文窗口让子代理执行，主窗口始终保持 30-40% 的低水位。今天关掉会话明天接着干，质量不降。

和技能包的区别：技能包给你能力，GSD 给你流程管理，解决"一个会话干到底、越干越差"的问题。

---

2. 适用场景

适合 1→10 阶段。 当你已经有一个在跑的项目，需要持续迭代多天、多人协作、防止上下文腐烂时，GSD 最对味。如果你的项目还处于"只有想法、没有代码"的 0→1 阶段，GSD 太重，不如先用 brainstorming + writing-plans 轻装上阵。

---

3. 它解决了什么问题

用过 AI 编程的人都会遇到：同一个会话用久了，AI 输出质量明显下降。上下文窗口被填满，早期的需求被挤掉，AI 开始"失忆"。这就是 上下文腐烂（context rot）——编排框架要解决的核心问题。

GSD 的解法很简单：不依赖一个超长会话，而是每个阶段开新窗口。做完规划，关掉，开新窗口执行；执行完验证，再开新窗口验证。每个子任务都是"满血状态"。

---

4. 核心亮点

4.1 六命令工作流

GSD 把开发过程标准化为 6 个命令，每个命令对应一个独立阶段：

命令	阶段	做什么
/gsd-new-project	初始化	创建项目骨架，生成需求文档
/gsd-discuss-phase	讨论	通过自适应提问明确实现决策，产出上下文文档
/gsd-plan-phase	规划	分析当前阶段要做什么、怎么做
/gsd-execute-phase	执行	开子代理执行任务（可并行）
/gsd-verify-work	验证	验证成果，含专用调试代理
/gsd-ship	交付	合并、提交、发布

另有 /gsd-resume-work（恢复上次上下文）、/gsd-pause-work（保存进度暂停）等 80+ 辅助命令（全量安装共 86 个命令），覆盖会话管理、代码审查、AI 交叉验证、codebase 分析等场景。最小安装（--minimal）仅含 6 个核心命令。

4.2 子代理编排

GSD 的核心机制：每个子任务开一个全新的上下文窗口。执行 /gsd-execute-phase 时，GSD 会生成子代理，每个子代理拥有独立的满额上下文（不继承主窗口的已用 token）。不依赖的任务可以并行执行。

主窗口只负责调度和汇总结果，不会被实现细节填满。

4.3 持久化工件

项目全程在文件系统中维护这些文档，不怕 /clear、不怕关窗口：

• PROJECT.md — 项目总览
• REQUIREMENTS.md — 需求规格
• ROADMAP.md — 路线图
• STATE.md — 当前进度状态
• CONTEXT.md — 跨会话上下文记忆

今天干到一半关掉，明天 /gsd-resume-work 接着干，所有状态都在。

4.4 跨平台

支持 Claude Code、OpenCode、Gemini CLI、Kilo、Codex、Copilot、Cursor、Windsurf 等 8+ 运行时。

---

5. 概览

项目	数据
仓库	github.com/gsd-build/get-shit-done
Stars	61K+
分叉	5.2K+
许可证	MIT
作者	TÂCHES（Lex Christopherson）
最新版本	v1.41.0（2026-05）

GSD 是专门为马拉松式项目设计的——那些需要做好几天的、中间会反复开关会话的长期任务。

---

6. 优点 & 缺点

✅ 优点	❌ 缺点
解决上下文腐烂，长会话不降质	快速迭代中，版本间偶尔有 break change
子代理独立上下文，并行执行	小任务用 GSD 太重
文件持久化，不怕会话丢失	需要学习工作流命令
跨 8+ 运行时	快速迭代中状态文件格式偶有变化，需关注 changelog

---

7. 安装方式

方式一：用 npx 装（支持平台：macOS / Linux / Windows）

终端执行：

npx get-shit-done-cc@latest

安装过程中会提示选择运行时（Claude Code 等）和安装范围（全局或项目级）。

---

8. 实战示例：用 GSD 开发一个 CLI 待办事项工具

假设你要开发一个命令行待办事项管理工具，技术栈选 Node.js + TypeScript。以下是完整操作步骤。每个 Step 都标注了操作位置和自动/手动的说明。

---

Step 1：初始化项目

在 Claude Code 聊天框输入斜杠命令：

/gsd-new-project

GSD 会在对话框里逐条提问，你逐条回答：

GSD → ? What is your project name?
你  → todo-cli

GSD → ? What tech stack?
你  → Node.js + TypeScript

GSD → ? Brief description?
你  → A CLI todo management tool with add/done/list/delete

回答完毕后，GSD 自动在项目目录下生成：

• PROJECT.md — 项目总览（名称、技术栈、简介）
• REQUIREMENTS.md — 需求规格（功能列表、技术选型详情）
• ROADMAP.md — 路线图（分 3 个 Phase，每个 Phase 的目标）

✅ Step 1 完成。接下来进入下一步。

---

Step 2：规划第一个阶段

在 Claude Code 聊天框输入（注意后面带参数 1，表示规划 Phase 1）：

/gsd-plan-phase 1

GSD 自动读取 REQUIREMENTS.md 中 Phase 1 的范围，输出规划：

GSD → 分析 Phase 1 范围：
      - Task CRUD（增删改查）
      - JSON 文件持久化
      - 命令行交互界面

GSD → 生成实现计划 → PLANS/phase-1.md

产出的 PLANS/phase-1.md 包含：

• 目录结构设计
• 数据模型（Todo 接口、存储层接口）
• CLI 命令设计（add / done / list / delete 四个子命令）
• 每个任务的预估工作量和依赖关系

✋ 你需要手动 review 这个计划，确认无误后，再进入下一步。

✅ Step 2 完成。接下来进入下一步。

---

Step 3：执行 Phase 1

在 Claude Code 聊天框输入（参数 1 表示执行 Phase 1）：

/gsd-execute-phase 1

GSD 自动将 Phase 1 拆成 3 个子任务，每个子任务开一个全新的上下文窗口并行执行：

子任务	内容	是否可并行
Task A	定义 Todo 接口和存储层（ITodoStore）	是
Task B	实现 CLI 命令解析（add/done/list/delete）	是（依赖 A 的接口）
Task C	实现 JSON 文件持久化（JsonTodoStore）	是

执行过程中，你在主窗口看到的进度：

GSD → Spawning sub-agents...
      Task A (data-model)   → 新窗口 → 进行中
      Task B (cli-parser)   → 新窗口 → 等待 Task A
      Task C (json-store)   → 新窗口 → 进行中
      ...
      3/3 tasks completed

执行完成后，GSD 自动汇总结果到 STATE.md，更新进度状态。你不需要手动合并子代理的代码。

✅ Step 3 完成。代码已经写好了，接着验证。

---

Step 4：验证成果

在 Claude Code 聊天框输入（参数 1 表示验证 Phase 1）：

/gsd-verify-work 1

GSD 自动启动验证代理：

GSD → Running tests...          PASS
      Linting codebase...       PASS  
      Type checking...          PASS
      Checking for edge cases...发现 1 个问题
      
      → 问题：delete 命令传入不存在的 ID 时未做错误处理
      → 启动调试代理修复...    DONE

验证代理发现 bug 会自动修复，修复完再跑一遍确保通过。你不需要手动修。

✅ Step 4 完成。验证通过后准备交付。

---

Step 5：交付

在 Claude Code 聊天框输入：

/gsd-ship

GSD 自动执行交付流程：

GSD → Creating git commit...        DONE
      Tagging v0.1.0...             DONE
      Generating release notes...   DONE
      PR created → 合并到主分支

🎉 至此，Phase 1（基础 CRUD）开发完成，已合并到主分支并打标签。整个过程你只输入了 5 条命令，中间不需要手动操作。

---

第二天继续开发

关掉会话后第二天回来，在 Claude Code 聊天框输入：

/gsd-resume-work

GSD 自动从 STATE.md 读取进度：

GSD → 恢复 Phase 1 已完成状态
      上次进度：Phase 1 done，下一步可规划 Phase 2

然后你接着输入 /gsd-plan-phase 2 开始下一阶段即可。所有状态都在文件里，不怕关窗口。

---

关键点：整个过程中，主窗口始终保持低水位（30-40% token 使用率），不会被实现细节填满。每个子代理干活时都是全新的满额上下文窗口（不继承主窗口的上下文消耗）。今天关掉明天 /gsd-resume-work 继续，质量不降。