GSD 是一个轻量但非常强大的 元提示(meta-prompting)+ 上下文工程 + 规范驱动开发系统,可用于 Claude Code、OpenCode、Gemini CLI 和 Codex 等 AI 编程环境。它的核心目标是解决 AI 编程过程中常见的 **“上下文腐烂(context rot)”**问题——随着对话上下文越来越长,模型理解能力下降,代码质量也随之变差。
通过系统化的上下文管理、任务规划和执行流程,GSD 可以让 AI 编程保持稳定、高质量和可持续。
什么是 GSD?
GSD(Get Shit Done) 是一个专为 **独立开发者(solo developer)**设计的上下文工程系统。它通过结构化项目状态、需求、路线图和执行计划,让 AI 能持续理解项目背景并稳定完成复杂任务。
GSD 的核心能力包括:
-
上下文工程(Context Engineering)
自动维护项目文档,例如PROJECT.md、ROADMAP.md、STATE.md等关键文件。 -
XML 结构提示(Structured Prompting)
每个计划都会生成优化的 XML 结构提示,使 AI 更准确理解任务目标。 -
多智能体协作(Multi-Agent Workflow)
研究、规划、执行、验证由不同智能体并行完成。 -
原子化 Git 提交(Atomic Commits)
每完成一个任务立即提交代码,保持清晰的 Git 历史记录。
这些机制使 AI 在大型项目中仍能保持稳定的开发质量。
系统要求
在安装 GSD 之前,需要准备以下环境:
-
Node.js ≥ 16.7.0
-
支持的 AI 运行环境:
-
Claude Code(主要支持)
-
OpenCode
-
Gemini CLI
-
Codex CLI
-
-
操作系统:
-
Windows
-
macOS
-
Linux
-
安装 GSD
交互式安装(推荐)
打开终端执行:
npx get-shit-done-cc@latest
安装程序会询问两个问题:
-
选择运行环境(Claude Code、OpenCode、Gemini、Codex 或全部)
-
选择安装位置(全局或当前项目)
安装完成后通常会看到类似输出:
✓ Installed commands/gsd
✓ Installed get-shit-done
✓ Installed agents
✓ Wrote VERSION
✓ Installed hooks
✓ Configured update check hook
✓ Configured context window monitor hook
Done! Open a blank directory in Claude Code and run /gsd:new-project.
非交互式安装
适用于脚本或 Docker 环境:
# 安装到 Claude Code(全局)
npx get-shit-done-cc --claude --global
# 安装到 Claude Code(当前项目)
npx get-shit-done-cc --claude --local
# 安装到 OpenCode
npx get-shit-done-cc --opencode --global
# 安装到 Gemini CLI
npx get-shit-done-cc --gemini --global
# 安装到 Codex
npx get-shit-done-cc --codex --global
# 安装到所有运行环境
npx get-shit-done-cc --all --global
开发模式安装
如果你想修改 GSD 源码,可以使用开发安装方式:
git clone https://github.com/glittercowboy/get-shit-done.git
cd get-shit-done
node bin/install.js --claude --local
验证安装
安装完成后,可以运行以下命令检查是否成功:
Claude Code 或 Gemini:
/gsd:help
OpenCode:
/gsd-help
Codex:
$gsd-help
如果终端输出完整命令说明,则说明安装成功。
推荐配置
跳过权限模式(强烈推荐)
GSD 的设计是 自动化执行任务,因此建议使用以下模式启动 Claude Code:
claude --dangerously-skip-permissions
否则每次执行 git commit 或 date 等命令都需要手动确认,会严重降低效率。
细粒度权限配置
如果不想完全跳过权限,可以在项目中创建:
.claude/settings.json
示例配置:
{
"permissions": {
"allow": [
"Bash(date:*)",
"Bash(ls:*)",
"Bash(cat:*)",
"Bash(git add:*)",
"Bash(git commit:*)",
"Bash(git status:*)",
"Bash(git log:*)"
]
}
}
GSD 的核心工作流程
GSD 的开发流程非常固定:
/gsd:new-project
↓
/gsd:discuss-phase
↓
/gsd:plan-phase
↓
/gsd:execute-phase
↓
/gsd:verify-work
然后进入下一个阶段。
整个流程可以理解为:
项目初始化 → 阶段讨论 → 阶段规划 → 执行 → 验证 → 循环
项目初始化
创建新项目:
/gsd:new-project
这个命令会执行完整初始化流程:
-
深度问答(理解项目目标)
-
可选研究(多个 AI agent 调研领域)
-
需求定义
-
创建项目路线图
初始化后会生成以下文件:
-
PROJECT.md— 项目愿景 -
REQUIREMENTS.md— 功能需求 -
ROADMAP.md— 项目阶段规划 -
STATE.md— 项目上下文状态 -
config.json— 工作流配置
阶段规划
在执行开发之前,需要先规划阶段。
讨论阶段目标:
/gsd:discuss-phase 1
创建执行计划:
/gsd:plan-phase 1
系统会生成类似文件:
.planning/phases/01-foundation/01-01-PLAN.md
这个文件包含:
-
具体任务
-
技术方案
-
成功标准
-
验证方法
执行阶段
执行某个阶段:
/gsd:execute-phase 1
执行过程具有以下特点:
-
计划按 波次(wave) 执行
-
同一波次的任务可以 并行运行
-
完成后自动验证结果
-
更新项目状态文件
这种方式可以让 AI 同时处理多个任务,同时保持依赖关系正确。
快速任务模式
对于简单任务,可以使用 快速模式:
/gsd:quick
例如:
“在设置页面添加暗色模式开关”
GSD 会自动:
-
生成计划
-
执行任务
-
提交代码
整个过程通常只需要几分钟。
调试功能
当项目出现问题时,可以使用:
/gsd:debug "登录按钮无法点击"
调试流程包括:
-
收集症状
-
建立假设
-
执行验证
-
找到根本原因
-
自动生成修复计划
如果会话中断,可以直接运行:
/gsd:debug
恢复调试流程。
待办事项管理
在开发过程中,可以随时记录想法:
/gsd:add-todo
或者指定内容:
/gsd:add-todo "添加文章搜索功能"
查看待办事项:
/gsd:check-todos
也可以按模块过滤:
/gsd:check-todos api
查看项目进度
查看当前项目状态:
/gsd:progress
系统会显示:
-
项目完成百分比
-
当前阶段
-
最近完成的任务
-
下一步建议操作
文件结构
GSD 会自动创建 .planning 目录来存储所有项目上下文:
.planning
├── PROJECT.md
├── ROADMAP.md
├── STATE.md
├── config.json
├── todos
├── debug
├── milestones
├── codebase
└── phases
这些文件构成了 AI 的长期记忆系统,确保每次会话都能恢复完整上下文。
总结
GSD 通过 上下文工程 + 多智能体协作 + 原子化提交,让 AI 编程从“偶尔靠谱”变成“稳定可控”。
使用 GSD 的主要优势包括:
-
保持 AI 对项目的长期记忆
-
将大型项目拆分为可执行阶段
-
自动生成规划和执行流程
-
保持清晰的 Git 历史
-
支持随时恢复工作上下文
对于 独立开发者、小团队或 AI 编程重度用户来说,GSD 是一个非常值得尝试的开发系统。
如果你希望 AI 在复杂项目中保持稳定表现,GSD 可能是目前最成熟的解决方案之一。







暂无评论内容