面向 AI 编码助手的规范驱动开发与上下文工程系统,通过六阶段结构化工作流解决上下文退化问题,支持 15+ 种 AI 编码运行时。
Get Shit Done (GSD) 是一个轻量级的元提示、上下文工程与规范驱动开发系统,专为 AI 编码助手设计。它通过将开发过程拆解为初始化、讨论、规划、执行、验证、交付六个原子化阶段,每个阶段使用全新上下文窗口,从根本上解决 AI 编码助手在长周期项目中的上下文退化(context rot)问题。
系统通过一组结构化文件实现跨会话的项目状态持久化与记忆传递:
- PROJECT.md — 项目愿景(始终加载)
- REQUIREMENTS.md — 带阶段可追溯性的需求
- ROADMAP.md — 路线图与进度
- STATE.md — 跨会话记忆(决策、阻塞、状态)
- PLAN.md — 带验证步骤的原子任务
- SUMMARY.md — 执行历史
- 辅助目录:
research/、todos/、threads/、seeds/
规范驱动开发流程#
| 阶段 | 命令 | 职责 |
|---|---|---|
| 项目初始化 | /gsd-new-project | 问答理解意图,生成需求、路线图、状态文件 |
| 阶段讨论 | /gsd-discuss-phase N | 捕获实现偏好,生成 CONTEXT.md |
| 阶段规划 | /gsd-plan-phase N | 并行研究 + 创建 2-3 个原子任务计划 |
| 阶段执行 | /gsd-execute-phase N | 波次并行执行,每个计划使用全新上下文窗口 |
| 工作验证 | /gsd-verify-work N | 自动 + 人工 UAT 验证,自动生成修复计划 |
| 交付 | /gsd-ship / /gsd-complete-milestone | 创建 PR / 完成里程碑 |
执行与质量机制#
- 波次并行执行:基于依赖关系自动分组,独立计划并行,依赖计划串行
- 原子提交:每个任务独立提交,保持干净 Git 历史
- 质量门控:schema drift 检测、安全验证锚定威胁模型、范围缩减检测
- Agent 尺寸预算:分层行数限制(XL: 1600, Large: 1000, Default: 500),违规在 CI 中报告
快捷与探索能力#
- Quick Mode(
/gsd quick):快速路径,支持--discuss、--research、--validate、--full组合标志 - Spiking(
/gsd-spike):运行 2-5 个聚焦实验 - Sketching(
/gsd-sketch):生成 2-3 个 HTML 交互原型 - 自动下一步(
/gsd-next):自动检测并运行下一步 - 代码库映射(
/gsd-map-codebase):并行 Agent 分析技术栈、架构、惯例
多运行时支持#
Claude Code、OpenCode、Gemini CLI、Kilo、Codex、Copilot、Cursor、Windsurf、Antigravity、Augment、Trae、Qwen Code、Cline、CodeBuddy 等 15+ 种 AI 编码助手。Claude Code 通过 @anthropic-ai/claude-agent-sdk 实现深度集成与子 Agent 编排。
架构概览#
GSD 采用 CLI 安装器 + SDK + 多 Agent 编排的分层架构:
- 安装器入口:
bin/install.js— Node.js CLI,支持交互式与非交互式(Docker/CI)安装 - SDK 层:
sdk/目录,TypeScript SDK,封装提示词模板与核心逻辑 - Agent 编排层:
agents/目录,覆盖研究、规划、执行、验证、调试等角色 - 命令注册层:
commands/gsd/目录,适配各 AI 运行时命令格式 - 钩子系统:
hooks/目录,Git 与生命周期钩子 - 测试体系:Vitest 框架 + c8 覆盖率工具,覆盖率要求 ≥ 70%
安装与上手#
前置要求:Node.js ≥ 22.0.0
npx get-shit-done-cc@latest
/gsd-help # 验证安装
安装器支持运行时多选、全局/本地安装、Claude Code 2.1.88+ 自动安装为 skills 格式(.claude/skills/)。典型流程:/gsd-new-project → /gsd-discuss-phase 1 → /gsd-plan-phase 1 → /gsd-execute-phase 1 → /gsd-verify-work 1 → /gsd-ship。
待确认信息#
- 无独立官方网站,以 GitHub README 为唯一文档来源
- SDK 公共 API 文档未详细说明,外部可编程调用能力待确认
ws依赖具体用途未在 README 中说明- 社区引用(Amazon、Google、Shopify、Webflow 工程师)仅见于 README 自述,无外部独立来源佐证
- npm 包名:
get-shit-done-cc,当前版本 1.38.2,MIT License(Lex Christopherson, 2025)