GSD (Get Shit Done) 调研报告

一、项目概述

基本信息

名称说明: 社区常称当前成熟版本为 "GSD-2" 以区别于早期简化版，但 GitHub 上只有一个仓库，并无独立的 "GSD-2" 产品。仓库用户名从 glittercowboy 迁移到 gsd-build（v1.29.0），但始终是同一个项目。

一句话介绍

GSD 是一个基于元提示（Meta-Prompting）的 AI 驱动软件开发框架，通过结构化的 XML 任务计划、多 Agent 编排和上下文工程，在 Claude Code 等 8+ 运行时上实现从需求到代码的端到端自动化。

发展历程

• 早期版本: 以 glittercowboy/get-shit-done 发布，作为 Claude Code 的 Prompt 文件集合
• v1.22.4: 新增 --discuss 快速模式，Windows 兼容性修复
• v1.23.0: UI-phase、节点修复（Node Repair）、Copilot 支持
• v1.24.0: Quick 研究模式、inherit 模型配置
• v1.25.0: Antigravity 支持、/gsd:do、/gsd:note、完整文档目录
• v1.26.0: 开发者画像、/gsd:ship、回归测试门禁、需求覆盖率门禁
• v1.27.0: Advisor 模式、Cursor CLI 支持、安全加固（路径遍历防护、提示注入检测、Shell 参数验证）
• v1.28.0: 工作流命名空间、法证分析、里程碑摘要、多项目工作区、CLAUDE.md 合规检查
• v1.29.0: Windsurf 支持、Agent 技能注入、安全扫描 CI、多语言文档、仓库迁移到 gsd-build
• v1.30.0: GSD SDK（@gsd-build/sdk）、--sdk 安装选项，从 Prompt 工具向可编程平台演进

定位

GSD 自定位为 AI 软件开发的元提示框架，核心差异化：

1. 元提示: 不直接编码，而是生成结构化 XML Prompt 让 AI Agent 执行
2. 多运行时: 支持 Claude Code、Cursor、Windsurf、Gemini CLI 等 8+ 运行时
3. 上下文工程: 通过文件系统管理上下文，解决"上下文腐化"问题
4. 结构化工作流: 需求讨论 → 计划 → 执行 → 验证 → 发布

二、核心功能

功能概览

核心功能详解

1. 元提示系统（核心创新）

GSD 的核心不是直接让 AI 编码，而是生成结构化的 XML Prompt：

<task>
  <name>实现 JWT 认证中间件</name>
  <files>src/middleware/auth.ts, src/utils/jwt.ts</files>
  <action>
    1. 创建 JWT 工具函数
    2. 实现认证中间件
    3. 添加类型定义
  </action>
  <verify>npm run test -- --grep "auth middleware"</verify>
  <done>所有认证中间件测试通过</done>
</task>

每个任务包含 5 个关键字段： - name: 人类可读的任务标识 - files: 任务涉及的文件列表 - action: 逐步操作指令 - verify: 验证成功的 Shell 命令 - done: 任务完成的条件

整个系统定义了 44 个 Slash 命令、46 个工作流、16+ 专用 Agent，全部以 Markdown Prompt 文件实现（无编译代码）。

2. 结构化工作流（Spec-Driven Development）

GSD 强制执行结构化的软件开发生命周期：

new-project → discuss-phase → plan-phase → execute-phase → verify-work → ship

3. 上下文工程（Context Engineering）

GSD 解决"上下文腐化"（Context Rot）问题——AI 输出质量随上下文窗口填满而下降：

传统方式:
Agent 长会话 → 上下文膨胀 → 质量下降 → 上下文腐化

GSD 方式:
编排器（30-40% 上下文占用） → 分派到新子 Agent（各自 200K 全新上下文）

上下文管理文件系统（.planning/ 目录）:

上下文监控: 编排器上下文占用 35% 时 WARNING，25% 时 CRITICAL，自动触发上下文压缩。

4. 多 Agent 编排（16+ 专用 Agent）

最小权限原则: 每个 Agent 只能访问必要的工具（如研究员不能写文件，执行器不能修改计划）。

5. Wave 执行

计划按依赖波次执行：

Wave 1（并行）:
├── Plan A: 用户认证（独立）
└── Plan B: 数据库设计（独立）

Wave 2（等待 Wave 1）:
└── Plan C: API 开发（依赖 A + B）

Wave 3（等待 Wave 2）:
└── Plan D: 集成测试（依赖 C）

并发控制: - 默认最大并发 Agent: 3 - STATE.md 使用 O_EXCL 原子文件锁防止并发写入冲突 - 并行 Agent 使用 --no-verify 提交避免构建锁争用

6. 计划检查（10 维度验证）

执行前，每个计划在 10 个维度上验证：

7. 节点修复（Node Repair）

任务失败时的自动恢复策略：

8. 模型配置

9. UI 设计合约

6 维度 UI 质量评估系统，每项 1-4 分： 1. 文案（Copywriting） 2. 视觉（Visuals） 3. 色彩（Color） 4. 排版（Typography） 5. 间距（Spacing） 6. 注册安全（Registry Safety — shadcn 集成的安全门控）

10. 安全加固（v1.27+）

纵深防御策略： - 路径遍历防护 - 集中式提示注入检测 + Hook 级别守卫 - 安全 JSON 解析 - Shell 参数验证 - 工作流守卫 - 安全扫描 CI 管道

三、安装配置

环境要求

安装

# 交互式安装（推荐）
npx get-shit-done-cc@latest

# 指定运行时
npx get-shit-done-cc@latest --runtime opencode    # 或 gemini, codex, copilot, windsurf, antigravity

# 带 SDK 安装
npx get-shit-done-cc@latest --sdk

# 设置全局默认
# 编辑 ~/.gsd/defaults.json

安装器（~3,000 行）自动处理： - 运行时检测和适配 - 文件部署（命令、工作流、Agent、Hook、工具） - 运行时特定转换（工具名称、路径、frontmatter） - 补丁备份和清单追踪

配置文件

GSD 使用项目内的 config.json：

{
  "mode": "default",
  "granularity": "high",
  "model_profile": "balanced",
  "planning": {},
  "workflow": {
    "skip_discuss": false,
    "skip_research": false,
    "skip_verify": false,
    "assumptions_mode": false,
    "text_mode": false,
    "ui_phase": false
  },
  "parallelization": {
    "max_concurrent_agents": 3,
    "min_plans_for_parallel": 2,
    "task_level": false
  },
  "git": {
    "branching_strategy": "none",
    "atomic_commits": true,
    "auto_stage": false
  },
  "gates": {
    "regression_gate": true,
    "coverage_gate": true
  }
}

四、架构设计

整体架构

┌──────────────────────────────────────────────────────────────────┐
│                      GSD 系统架构                                 │
├──────────────────────────────────────────────────────────────────┤
│                                                                  │
│  ┌──────────────────────────────────────────────────────────┐   │
│  │                AI 运行时层                                 │   │
│  │  Claude Code │ Cursor │ Windsurf │ Gemini CLI │ Codex ... │   │
│  └──────────────────────────┬───────────────────────────────┘   │
│                             │ Slash 命令                        │
│  ┌──────────────────────────▼───────────────────────────────┐   │
│  │             GSD 元提示层（Markdown Prompt 文件）            │   │
│  │  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────────┐ │   │
│  │  │ 44 个    │ │ 46 个    │ │ 16+ 个   │ │ 安装器       │ │   │
│  │  │ 命令     │ │ 工作流   │ │ Agent    │ │ (3,000 行)   │ │   │
│  │  └──────────┘ └──────────┘ └──────────┘ └──────────────┘ │   │
│  └──────────────────────────┬───────────────────────────────┘   │
│                             │                                    │
│  ┌──────────────────────────▼───────────────────────────────┐   │
│  │             上下文管理层（.planning/ 文件系统）              │   │
│  │  PROJECT.md │ REQUIREMENTS.md │ STATE.md │ PLAN.md │ ...  │   │
│  └──────────────────────────┬───────────────────────────────┘   │
│                             │                                    │
│  ┌──────────────────────────▼───────────────────────────────┐   │
│  │             编排层                                         │   │
│  │  编排器(30-40%上下文) → 分派子Agent(各自200K全新上下文)     │   │
│  │  Wave 执行 │ 上下文监控 │ 节点修复 │ 安全守卫              │   │
│  └──────────────────────────────────────────────────────────┘   │
│                                                                  │
└──────────────────────────────────────────────────────────────────┘

核心设计原则

数据流（执行管线）

1. 用户输入需求
       │
       ▼
2. /gsd:new-project → 初始化 .planning/ 目录
       │
       ▼
3. /gsd:discuss-phase → 3-4 并行研究 Agent → 合成 REQUIREMENTS.md
       │
       ▼
4. /gsd:plan-phase → Planner Agent 生成 XML 计划 → 10 维度检查
       │
       ▼
5. /gsd:execute-phase → Wave 执行:
   ┌──────────────────────────────────┐
   │  a. 编排器分发任务到子 Agent      │
   │  b. 子 Agent 获得全新 200K 上下文 │
   │  c. 子 Agent 执行并返回结果       │
   │  d. 原子 Git 提交                 │
   │  e. 上下文监控检查                │
   │  f. 失败则节点修复                │
   │  g. 下一波次                     │
   └──────────────────────────────────┘
       │
       ▼
6. /gsd:verify-work → UAT 验证
       │
       ▼
7. /gsd:ship → 最终提交和发布

五、使用场景

适用场景

不适用场景

• 快速小修改（GSD 工作流过于重量级）
• 探索性编码（结构化流程限制自由度）
• 非 Claude Code 用户（需要支持的运行时）
• 对 AI 生成代码有严格合规要求的场景

社区反馈

YouTube 覆盖:

Reddit 讨论（r/ClaudeCode）:

社区情绪模式: 主流用户（39-45K 播放量视频）以正面为主。批评主要来自少数 YouTuber（Charlie Automates 等），认为 GSD 的线性流程过于僵化，并推荐竞品（PAUL、SEED）。

六、对比分析

GSD vs Claude Code（裸用）

GSD vs 竞品框架

PAUL: - 定位为比 GSD 更灵活的替代方案 - 20K 播放量 YouTube 视频专门对比 - 常与 SEED 组合使用

Ralph Loops: - GSD 的前身框架 - 多个视频定位 GSD 为 Ralph 的替代 - "Stop Using Ralph Loops (Use This Instead)" — 36K 播放

Superpowers: - Reddit 讨论中与 GSD 的 plan mode 对比 - Claude Code 增强框架

BMAD: - 竞争格局中提及，较少详细覆盖

GSD v1 早期 vs GSD 当前

选型建议

• 选择 GSD: 大型功能开发、需要结构化流程、多阶段项目
• 选择 Claude Code 裸用: 快速任务、探索性编码、简单修改
• 选择 PAUL: 需要更灵活的工作流、不喜线性流程
• 选择 Cursor/Windsurf: 需要 IDE 深度集成、GUI 体验

七、最佳实践

推荐做法

1. 遵循完整流程: 新项目走 discuss → plan → execute → verify → ship
2. 利用 /gsd:quick: 小任务不需要完整流程，用 quick 模式
3. 使用 balanced 配置: 日常开发推荐 balanced 模型配置
4. 开启原子提交: 确保每个任务有独立 Git 提交
5. 让 Agent 并行: 设置 max_concurrent_agents: 3 充分利用并行
6. 善用 /gsd:map-project: 存量代码先映射再开发

避坑指南

1. 不要跳过 discuss 阶段: 需求不清会导致后续大量返工
2. 不要过度依赖 Auto 模式: 复杂项目建议分阶段手动推进
3. 注意上下文监控: 编排器上下文超过 75% 时需要主动压缩
4. 检查生成的计划: 10 维度验证不是万能的，人工审查仍有价值
5. 关注 Token 消耗: quality 配置 + 并行执行会大量消耗 Token

八、总结

优势

1. 元提示创新: 不直接编码而是生成 AI 可执行的结构化 Prompt，理念先进
2. 上下文工程: 编排器 30-40% 上下文 + 子 Agent 各自 200K 全新上下文，有效解决上下文腐化
3. 结构化流程: discuss → plan → execute → verify → ship 全生命周期覆盖
4. 多运行时: 8+ AI 编码运行时支持，不锁定单一工具
5. 10 维度验证: 执行前严格验证计划质量
6. 生态最大: 45K Stars，社区活跃，持续迭代
7. 安全加固: 路径遍历、注入检测、Shell 验证等纵深防御
8. SDK 支持: v1.30.0 引入 @gsd-build/sdk，向可编程平台演进

劣势

1. 学习曲线: 44 个命令 + 46 个工作流 + 16 个 Agent，概念体系庞大
2. 流程僵化: 线性的 Spec-Driven 流程对灵活场景不够友好
3. 重量级: 小任务用 GSD 过于繁琐
4. 依赖运行时: GSD 本身不是独立工具，依赖 Claude Code 等宿主
5. Token 消耗: 多 Agent + 并行执行消耗大量 Token
6. 竞争激烈: PAUL、SEED、Superpowers 等竞品不断涌现

最终建议

GSD 在 AI 辅助开发框架领域建立了标杆——通过元提示和上下文工程，将 AI 编码从"对话式辅助"提升到"结构化自动化"。对于以下用户特别有价值：

• 推荐使用: 大型功能开发、需要结构化流程、已有 Claude Code 使用经验的团队
• 观望: 日常编码以小任务为主、偏好 IDE 集成、不需要结构化流程的开发者
• 关注趋势: GSD 代表的"元提示 + 上下文工程 + 多 Agent 编排"理念，是 AI Agent 工程化的重要方向

参考资料

• GitHub 仓库: https://github.com/gsd-build/get-shit-done
• npm 包: https://www.npmjs.com/package/get-shit-done-cc
• YouTube: "GSD 2 vs Claude Code: A New AI King?" (Chase AI, 41K views)
• YouTube: "I Created GSD For Claude Code" (TÂCHES TEACHES, 45K views)
• Reddit: r/ClaudeCode GSD 相关讨论
• 竞品: PAUL, SEED, Ralph Loops, Superpowers, BMAD