GET SHIT DONE (GSD) - Claude Code 上下文工程与规范驱动开发系统

为什么需要 GSD

上下文腐化，是 AI 编码的最大杀手

随着对话越来越长，Claude 的上下文窗口被历史信息填满，代码质量开始退化，AI 开始变得不可靠。

😤

没有 GSD 的情况

你告诉 Claude 你想要什么，它生成了代码，但随着对话变长，AI 开始忘记上下文、做出不一致的决策。

随着 token 消耗，输出质量逐渐下降
AI 不知道整体项目目标和约束
每次新会话都需要重新解释背景
代码风格和架构决策不一致
"振错方向开发"浪费大量时间

⚡

使用 GSD 之后

GSD 将复杂的上下文工程封装成简单命令。你只需描述想法，系统处理其余一切。

每个任务在新鲜的 200k 上下文中执行
PROJECT.md / STATE.md 跨会话保持记忆
并行子代理独立研究和执行
每个任务都有原子 git 提交
自动验证确保交付与目标一致

核心工作流

六步完成一个里程碑

循环执行 discuss → plan → execute → verify，直到里程碑完成。每一步都有专属的 AI 代理负责。

/gsd:new-project

初始化项目

系统向你提问，直到完全理解你的想法（目标、约束、技术偏好、边界情况）。然后生成需求清单和分阶段路线图，供你确认。

生成：PROJECT.md · REQUIREMENTS.md · ROADMAP.md · STATE.md

/gsd:discuss-phase [N]

讨论阶段细节

在规划之前捕获你对这一阶段的具体偏好：布局方式、API 格式、错误处理策略等。这些偏好会直接输入给研究员和规划员，确保按你的方式构建。

生成：{N}-CONTEXT.md

/gsd:plan-phase [N]

研究与规划

4 个并行研究代理分别调查技术栈、功能实现、架构设计和潜在坑点。规划员基于研究结果创建 2-3 个原子任务计划，检查器验证计划是否满足需求。

生成：{N}-RESEARCH.md · {N}-{K}-PLAN.md

/gsd:execute-phase [N]

并行波浪执行

按依赖关系将任务分组为"波浪"。同一波中的计划并行执行，每个执行器获得完整的 200k 上下文窗口。每个任务完成后立即提交原子 commit。

生成：{N}-{K}-SUMMARY.md · {N}-VERIFICATION.md

/gsd:verify-work [N]

用户验收测试

系统提取可测试的交付物，逐一引导你验证功能是否符合预期。如果发现问题，自动派遣 debug 代理定位根因，生成修复计划供下次执行。

生成：{N}-UAT.md · 修复计划（如有问题）

/gsd:complete-milestone

完成里程碑

归档当前里程碑，打上 git tag。然后用 /gsd:new-milestone 开始下一个版本周期。系统了解你的现有代码库，新的问题将聚焦于你要新增的内容。

操作：归档里程碑 · 创建 git tag · 准备下一里程碑

核心特性

让 Claude Code 可靠的技术原理

复杂性在系统内部，简单性留给你的工作流。

🧠

上下文工程

精心设计的文件系统作为 AI 的"外部记忆"。PROJECT.md 永远加载，STATE.md 跨会话保存决策，每个计划都有 XML 结构化指令，让 Claude 始终知道自己在做什么。

⚡

多代理编排

每个阶段由薄编排器协调多个专业代理并行工作。研究、规划、执行、验证各有专职代理。编排器从不做重活，只负责协调和路由。

🔄

波浪并行执行

根据依赖关系将任务分组。同一波中的无关任务并行执行，每个执行器获得完整的干净上下文窗口。整个阶段执行完毕后你的主会话仍只消耗 30-40%。

📝

XML 结构化提示

每个计划都是专为 Claude 优化的 XML 格式：精确的指令、明确的验证步骤、内置的完成标准。不猜测，不模糊。每条指令都有对应的验收标准。

🔀

原子 Git 提交

每个任务完成后立即产生专属 commit。清晰可追溯的 git 历史，可精确 bisect 定位问题，每个任务独立可回滚，Claude 在未来会话中也能读懂这段历史。

🏗️

模块化设计

可以随时在里程碑中添加、插入、删除阶段。在两个阶段之间插入紧急工作，完成里程碑后无缝开始下一版本。你永远不会被锁死在当前计划里。

🌍

多运行时支持

原生支持 Claude Code、OpenCode（免费开源模型）和 Gemini CLI。一次安装命令选择运行时，或同时安装到所有平台。适应不同的工具链偏好。

🎛️

灵活模型配置

三种模型配置（质量/平衡/预算）控制每个代理使用的 Claude 模型。规划用 Opus，执行用 Sonnet，验证用 Haiku。精确平衡质量与 token 消耗。

🔒

安全内置保护

内置防止意外提交 secrets 的保护。支持 Claude Code deny list 配置，阻止 GSD 读取 .env 等敏感文件。安全防线从工具层开始。

命令参考

完整命令速查表

所有命令都在 Claude Code 内以 /gsd: 前缀使用。

🎯 核心工作流

/gsd:new-project 全流程初始化：提问 → 研究 → 需求 → 路线图

/gsd:discuss-phase [N] 在规划前捕获实现决策和个人偏好

/gsd:plan-phase [N] 为指定阶段执行研究、生成计划、验证

/gsd:execute-phase <N> 按波浪并行执行所有计划，完成后验证

/gsd:verify-work [N] 手动用户验收测试，自动诊断问题

/gsd:complete-milestone 归档里程碑，打 tag，准备下一版本

/gsd:new-milestone 基于现有代码库开始下一版本迭代

🔧 实用工具

/gsd:quick [--full] 快速执行临时任务（bug修复、小功能）

/gsd:map-codebase 分析已有代码库的架构、约定和技术栈

/gsd:progress 查看当前进度：我在哪里？下一步是什么？

/gsd:health [--repair] 验证 .planning/ 目录完整性，自动修复

/gsd:debug [desc] 系统化调试模式，持久化 debug 状态

/gsd:settings 配置模型配置文件和工作流代理开关

/gsd:pause-work 创建交接文档，安全停止当前阶段

上下文工程

AI 的"外部记忆"系统

GSD 使用精心设计的文件结构作为 Claude 的持久记忆，每个文件都有严格的大小限制，防止上下文退化。

文件	作用	大小建议
PROJECT.md	项目愿景，每次会话都会加载。你是什么、为什么存在、技术选型	~500 词
REQUIREMENTS.md	按 v1/v2 划分的需求清单，带阶段可追溯性，标记完成状态	~300-800 词
ROADMAP.md	分阶段路线图，已完成阶段归档，告诉 AI 你要去哪	~200-400 词
STATE.md	跨会话持久化的决策、阻碍和当前位置。AI 的"工作记忆"	~200-500 词
{N}-CONTEXT.md	你对这个阶段的具体偏好：布局、格式、交互方式等	~300-600 词
{N}-RESEARCH.md	4 个研究代理的调查结果：技术栈、功能、架构、坑点	~800-1500 词
{N}-{K}-PLAN.md	XML 结构化的原子任务：文件、操作、验证步骤、完成标准	~400-800 词
{N}-{K}-SUMMARY.md	任务完成后的总结：变更了什么、提交了什么	~200-400 词

常见疑问

GSD 相当于给 Claude 加了记忆吗？

某种意义上是，但它和 Claude 自带的记忆功能有本质区别。

	Claude 原生记忆	GSD 外部记忆
存储位置	Anthropic 服务器（需手动开启）	你本地的项目文件
作用范围	账号级别，跨所有对话	单个项目目录，精准隔离
内容结构	你告诉它记住的零散信息	结构化的需求 / 路线图 / 决策 / 状态
控制权	Anthropic 管理	完全在你自己手里
解决的问题	跨对话的基础偏好记忆	上下文腐化 + 项目级规划一致性

不同项目完全独立

GSD 的记忆文件都存在每个项目自己的 .planning/ 目录里。你在哪个项目目录里打开 Claude，它就只加载那个项目的上下文，项目之间完全隔离，没有任何串扰。

项目A/
├── .planning/
├── PROJECT.md ← 项目A的愿景
└── STATE.md ← 项目A的状态

项目B/
├── .planning/
├── PROJECT.md ← 完全独立
└── STATE.md ← 互不影响

命令全局安装，记忆局部存储

GSD 的命令（/gsd:*）可以全局安装到 ~/.claude/，所有项目都能用这套工具。但每个项目的"记忆内容"保存在各自目录下，永远不会混淆。

🔧

工具命令

~/.claude/commands/gsd/ · 全局共享

🧠

项目记忆

[项目目录]/.planning/ · 各项目独立

快速开始

一行命令，立即开始

GSD 通过 npx 安装，无需全局安装，始终使用最新版本。安装过程会提示你选择运行时和安装位置。

🌍

全局安装

安装到 ~/.claude/，对所有项目生效

📁

本地安装

安装到 ./.claude/，仅当前项目使用

🔄

保持更新

GSD 迭代很快，定期重新运行安装命令

💻

跨平台支持

Mac、Windows、Linux 均可使用

Step 1 · 安装 GSD

bash

$ npx get-shit-done-cc@latest

# 非交互式安装（CI/Docker）
$ npx get-shit-done-cc --claude --global
$ npx get-shit-done-cc --opencode --global
$ npx get-shit-done-cc --gemini --global
$ npx get-shit-done-cc --all --global

Step 2 · 启动并验证

bash

# 推荐：跳过权限模式，减少确认提示
$ claude --dangerously-skip-permissions

# 验证安装
> /gsd:help

# 开始新项目
> /gsd:new-project

Step 3 · 已有代码库？先分析

bash

# 先分析现有代码库
> /gsd:map-codebase

# 然后初始化项目
> /gsd:new-project
# 系统已了解你的技术栈和约定

配置

按需配置，精准控制

所有设置存储在 .planning/config.json，通过 /gsd:settings 命令管理，或直接在 new-project 初始化时配置。

⚙️ 核心模式

mode	yolo（自动确认）或 interactive（每步确认）
depth	quick / standard / comprehensive 控制规划深度
auto_advance	自动链接 discuss→plan→execute 全流程

🤖 模型配置

quality	规划 Opus · 执行 Opus · 验证 Sonnet
balanced	规划 Opus · 执行 Sonnet · 验证 Sonnet
budget	规划 Sonnet · 执行 Sonnet · 验证 Haiku

🔀 工作流代理

research	规划前研究领域（默认开启）
plan_check	执行前验证计划（默认开启）
verifier	执行后确认交付（默认开启）

社区反馈

来自真实用户的声音

被 Amazon、Google、Shopify、Webflow 的工程师信赖使用。

如果你清楚地知道自己想要什么，GSD 就能为你构建它。没有废话。

Solo Developer

GSD 用户

我用过 SpecKit、OpenSpec 和 Taskmaster，GSD 给我带来了最好的结果。

Engineer

独立开发者

迄今为止对 Claude Code 最强大的补充。没有过度工程化。字面意思就是把事情搞定。

Developer

开源贡献者