GSD 初学者完全指南：讨论→规划→执行→验证
作为初学者，使用 Get Shit Done (GSD) 的核心逻辑是遵循其"讨论 → 规划 → 执行 → 验证"的结构化流程。你只需要记住三个最常用的命令：使用 /gsd-new-project 开启新项目，使用 /gsd-quick 处理简单任务，以及使用 /gsd-help 查看帮助。
快速上手指南
1. 安装与环境准备
首先，在你的终端运行安装命令：
npx get-shit-done-cc@latest
安装程序会引导你选择运行环境（如 Claude Code 或 Gemini）以及安装位置（全局或仅当前项目）。
2. 核心工作流程
如果你要开始一个完整的项目开发，请按顺序执行以下步骤：
| 步骤 | 命令 | 作用 |
|---|---|---|
| 项目初始化 | /gsd-new-project | AI 会通过提问了解你的想法，生成需求文档和路线图 |
| 锁定偏好 | /gsd-discuss-phase 1 | 针对当前阶段（如阶段 1）讨论具体细节，避免 AI 乱猜 |
| 制定计划 | /gsd-plan-phase 1 | 系统会自动研究实现方案并拆解成多个原子任务计划 |
| 自动化执行 | /gsd-execute-phase 1 | AI 开始编写代码，每个任务都会有独立的 Git 提交 |
| 验收成果 | /gsd-verify-work 1 | 系统引导你手动测试功能，确保符合预期 |
3. 处理临时任务 (快速模式)
如果你只想修个 Bug 或加个小功能，不需要完整的规划流程，直接使用：
/gsd-quick
它会跳过繁琐的步骤，直接进入规划与执行，同时保留原子提交和状态跟踪的优点。
各步骤详解
项目初始化：/gsd-new-project
一条命令，一个流程。系统会：
- 提问 —— 问到完全理解你的想法为止（目标、约束、技术偏好、边缘情况）
- 研究 —— 生成并行代理调查领域（可选但推荐）
- 需求 —— 提取哪些是 v1、v2 和范围外
- 路线图 —— 创建映射到需求的阶段
你批准路线图。现在准备好构建了。
创建文件：PROJECT.md、REQUIREMENTS.md、ROADMAP.md、STATE.md、.planning/research/
讨论阶段：/gsd-discuss-phase 1
这是你塑造实现方式的地方。
你的路线图每个阶段有一两句话。这不足以按照你想象的方式构建东西。这一步在研究或规划之前捕获你的偏好。
系统分析阶段并根据正在构建的内容识别灰色区域：
- 视觉功能 → 布局、密度、交互、空状态
- API/CLI → 响应格式、标志、错误处理、详细程度
- 内容系统 → 结构、语气、深度、流程
- 组织任务 → 分组标准、命名、重复项、例外
对于你选择的每个领域，它会问到让你满意为止。输出 —— CONTEXT.md —— 直接输入接下来的两个步骤：
- 研究员读取它 —— 知道要调查什么模式（"用户想要卡片布局" → 研究卡片组件库）
- 规划者读取它 —— 知道哪些决策已锁定（"无限滚动已决定" → 规划包含滚动处理）
你在这里走得越深，系统构建的就越是你真正想要的。跳过它你会得到合理的默认值。使用它你会得到你的愿景。
创建文件：{阶段号}-CONTEXT.md
制定计划：/gsd-plan-phase 1
系统：
- 研究 —— 调查如何实现这个阶段，由你的 CONTEXT.md 决策指导
- 规划 —— 创建 2-3 个带有 XML 结构的原子任务计划
- 验证 —— 根据需求检查计划，循环直到通过
每个计划足够小，可以在全新的上下文窗口中执行。没有退化，没有"我现在会更简洁"。
创建文件：{阶段号}-RESEARCH.md、{阶段号}-{N}-PLAN.md
自动执行：/gsd-execute-phase 1
系统：
- 按波次运行计划 —— 可能的话并行，有依赖时顺序
- 每个计划全新上下文 —— 200k token 纯粹用于实现，零累积垃圾
- 每个任务提交 —— 每个任务都有自己的原子提交
- 根据目标验证 —— 检查代码库是否交付了阶段承诺的内容
离开，回来看到完成的工作和干净的 git 历史。
波次执行工作原理：
计划根据依赖关系分组到"波次"。在每个波次内，计划并行运行。波次顺序执行。
┌─────────────────────────────────────────────────────┐
│ 阶段执行 │
├─────────────────────────────────────────────────────┤
│ 波次 1 (并行) 波次 2 (并行) 波次 3 │
│ ┌─────────┐┌─────────┐ ┌─────────┐┌─────────┐ │
│ │ 计划 01 ││ 计划 02 │→│ 计划 03 ││ 计划 04 │→... │
│ │ 用户模型 ││ 产品模型 │ │ 订单API ││ 购物车 │ │
│ └─────────┘└─────────┘ └─────────┘└─────────┘ │
│ │ │ ↑ ↑ │
│ └─────────┴────────────┴──────────┘ │
│ 依赖关系驱动波次顺序 │
└─────────────────────────────────────────────────────┘
为什么波次重要：
- 独立计划 → 同一波次 → 并行运行
- 依赖计划 → 后续波次 → 等待依赖
- 文件冲突 → 顺序计划或同一计划
这就是为什么"垂直切片"（计划 01: 用户功能端到端）比"水平分层"（计划 01: 所有模型，计划 02: 所有 API）并行化更好。
创建文件：{阶段号}-{N}-SUMMARY.md、{阶段号}-VERIFICATION.md
验收成果：/gsd-verify-work 1
这是你确认它真的有效的地方。
自动化验证检查代码存在和测试通过。但功能是否按你预期的方式工作？这是你使用它的机会。
系统：
- 提取可测试交付物 —— 你现在应该能做什么
- 逐个引导你 —— "你能用邮箱登录吗？" 是/否，或描述有什么问题
关键提示
- 不要跳过讨论：在
discuss-phase中回答得越详细，AI 生成的代码就越符合你的心意 - 查看进度：如果中途停下了，可以使用
/gsd-progress查看当前状态 - 遇到困难：随时输入
/gsd-help获取详细的命令说明
注意事项
- GSD 的所有状态都存储在本地的
.planning/目录下，不要手动删除这个文件夹，否则会丢失项目进度 - 系统采用"目标倒推"方法，确保每一行代码都有据可查