GSD (Get Shit Done) 使用指南:让 Claude Code 为你高效构建项目

GSD (Get Shit Done) 使用指南:让 Claude Code 为你高效构建项目

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.mdROADMAP.mdSTATE.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

安装程序会询问两个问题:

  1. 选择运行环境(Claude Code、OpenCode、Gemini、Codex 或全部)

  2. 选择安装位置(全局或当前项目)

安装完成后通常会看到类似输出:

✓ 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 commitdate 等命令都需要手动确认,会严重降低效率。


细粒度权限配置

如果不想完全跳过权限,可以在项目中创建:

.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

这个命令会执行完整初始化流程:

  1. 深度问答(理解项目目标)

  2. 可选研究(多个 AI agent 调研领域)

  3. 需求定义

  4. 创建项目路线图

初始化后会生成以下文件:

  • 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 会自动:

  1. 生成计划

  2. 执行任务

  3. 提交代码

整个过程通常只需要几分钟。


调试功能

当项目出现问题时,可以使用:

/gsd:debug "登录按钮无法点击"

调试流程包括:

  1. 收集症状

  2. 建立假设

  3. 执行验证

  4. 找到根本原因

  5. 自动生成修复计划

如果会话中断,可以直接运行:

/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 可能是目前最成熟的解决方案之一。

© 版权声明
THE END
喜欢就支持一下吧
点赞6 分享
评论 抢沙发

请登录后发表评论

    暂无评论内容