gsd

Get Shit Done (GSD) - 项目管理系统

专为与 Claude AI Agent 协作的独立开发者设计的综合项目管理系统。GSD 提供了结构化工作流，涵盖项目初始化、规划、执行、验证和调试。

概述

GSD 是一个模块化的 Agent 系统，可通过以下流程将项目创意转化为已交付的软件：

1. 深入提问 - 提取用户愿景和需求
2. 领域研究 - 发现标准技术栈和模式
3. 创建路线图 - 将需求拆分为多个阶段
4. 阶段规划 - 创建包含验证步骤的可执行计划
5. 执行 - 通过原子提交实施计划
6. 验证 - 确保实现目标，而不只是完成任务
7. 调试 - 系统化地调查问题

核心理念

• 独立开发者 + Claude 工作流 - 不需要团队、利益相关者或例会
• 计划就是提示词 - PLAN.md 文件就是执行提示词，而非文档
• 目标反推式规划 - 从必须实现的结果出发，推导需要构建的内容
• 原子提交 - 每项任务独立提交，保持提交历史清晰
• 质量优先于速度 - 在上下文质量下降前停止（约使用 50% 时）
• 快速交付 - 规划 → 执行 → 交付 → 学习 → 重复

何时使用 GSD

在以下情况使用 GSD：

• 初始化新的软件项目
• 规划并执行开发阶段
• 梳理现有代码库
• 系统化地调试问题
• 验证阶段是否完成
• 跟踪项目进度和状态

快速入门命令

新建项目

/gsd:new-project

按照提问 → 研究 → 需求 → 路线图的流程初始化新项目。

规划阶段

/gsd:plan-phase [phase-number]

通过研究和验证创建详细的执行计划。

执行阶段

/gsd:execute-phase [phase-number]

执行某个阶段中的所有计划，并支持并行执行。

梳理代码库

/gsd:map-codebase [optional-focus-area]

通过并行的映射 Agent 分析现有代码库。

调试问题

/gsd:debug [issue-description]

使用科学方法和假设检验进行系统化调试。

验证阶段

/gsd:verify-work [phase-number]

通过目标反推式验证检查阶段是否完成。

查看进度

/gsd:progress

显示当前项目进度、已完成阶段和后续步骤。

Agent 技能

GSD 包含面向不同任务的专用 Agent：

• gsd-codebase-mapper - 探索并记录代码库结构
• gsd-planner - 创建可执行的阶段计划
• gsd-executor - 通过原子提交执行计划
• gsd-debugger - 系统化地调查 Bug
• gsd-verifier - 验证目标是否实现
• gsd-research-synthesizer - 综合研究成果
• gsd-roadmapper - 创建项目路线图
• gsd-phase-researcher - 研究阶段实施方案
• gsd-project-researcher - 研究领域生态
• gsd-integration-checker - 验证集成是否正常工作
• gsd-plan-checker - 验证计划质量

命令技能

GSD 提供用于编排整个项目生命周期的命令：

• gsd:new-project - 初始化新项目
• gsd:map-codebase - 梳理现有代码库
• gsd:plan-phase - 规划阶段
• gsd:execute-phase - 执行阶段
• gsd:verify-work - 验证阶段是否完成
• gsd:debug - 调试问题
• gsd:discuss-phase - 收集阶段背景信息
• gsd:research-phase - 研究阶段实施方案
• gsd:complete-milestone - 完成里程碑
• gsd:audit-milestone - 审核里程碑
• gsd:add-phase - 添加新阶段
• gsd:insert-phase - 插入阶段
• gsd:remove-phase - 移除阶段
• gsd:add-todo - 添加待办事项
• gsd:check-todos - 检查待办事项
• gsd:plan-milestone-gaps - 规划里程碑差距
• gsd:pause-work - 暂停工作
• gsd:resume-work - 恢复工作
• gsd:update - 更新项目状态
• gsd:whats-new - 显示新内容

工作流技能

复杂操作的详细工作流定义：

• discovery-phase - 阶段发现工作流
• execute-phase - 阶段执行工作流
• diagnose-issues - 并行 UAT 诊断
• map-codebase - 代码库映射工作流
• discuss-phase - 阶段讨论工作流
• verify-phase - 阶段验证工作流
• verify-work - 工作验证工作流
• transition - 阶段过渡工作流
• resume-project - 项目恢复工作流

参考技能

最佳实践和指南的参考文档：

• questioning - 深度提问技巧
• tdd - 测试驱动开发模式
• ui-brand - UI/UX 指南
• verification-patterns - 验证方法
• git-integration - Git 工作流模式
• checkpoints - 检查点处理
• continuation-format - 延续格式规范

项目结构

GSD 会创建一个 .planning/ 目录，其中包含：

.planning/
├── PROJECT.md           # Project context and vision
├── config.json          # Workflow preferences
├── REQUIREMENTS.md      # Scoped requirements
├── ROADMAP.md          # Phase structure
├── STATE.md            # Project memory and state
├── research/            # Domain research outputs
├── phases/              # Phase-specific artifacts
│   ├── XX-name/
│   │   ├── XX-PLAN.md
│   │   ├── XX-SUMMARY.md
│   │   ├── XX-CONTEXT.md
│   │   ├── XX-RESEARCH.md
│   │   ├── XX-VERIFICATION.md
│   │   └── XX-UAT.md
└── codebase/            # Codebase analysis
    ├── STACK.md
    ├── ARCHITECTURE.md
    ├── STRUCTURE.md
    ├── CONVENTIONS.md
    ├── TESTING.md
    ├── INTEGRATIONS.md
    └── CONCERNS.md

核心概念

目标反推规划

不要问“我们应该构建什么？”，而要问“要实现目标，哪些条件必须成立？”

正向规划：“构建身份验证系统” → 任务列表 目标反推：“用户可以安全地访问账户” → 推导出必须具备的内容

原子提交

每项任务都会独立提交，并附上描述性消息：

feat(01-01): implement user login
fix(01-02): fix password validation
test(01-03): add login tests

上下文预算

计划会在上下文用量约为 50% 时完成，以保持质量：

• 0-30%：质量峰值
• 30-50%：质量良好
• 50-70%：质量下降
• 70%+：质量较差（应避免）

基于波次的执行

计划会分组为多个波次，以便并行执行：

• **波次 1：**独立计划（无依赖项）
• **波次 2：**仅依赖波次 1 的计划
• **波次 3：**依赖波次 2 的计划，依此类推。

应避免的反模式

• 企业级项目管理表演 - 不使用 RACI 矩阵、冲刺仪式或利益相关者管理
• 横向分层 - 不要按“先列出所有模型，再列出所有 API”分组，而应按功能分组
• 模糊的成功标准 - 将“身份验证正常”改为“用户可以使用电子邮件/密码登录”
• 时间估算 - 绝不按小时、天或周进行估算
• 任务完成 ≠ 目标达成 - 验证结果，而不只是确认任务完成

获取帮助

每个 Agent、命令和工作流都有自己的 SKILL.md，其中包含详细说明。请使用：

• @skills/gsd/agents/ 获取 Agent 专属帮助
• @skills/gsd/commands/ 获取命令专属帮助
• @skills/gsd/workflows/ 获取工作流专属帮助
• @skills/gsd/references/ 获取参考文档

版本

GSD 版本：1.0.0 最后更新：2026-01-19