gsd-build/get-shit-done
⭐ 61,244 · JavaScript · GitHub 仓库
轻量级且强大的元提示、上下文工程与规范驱动开发系统,专为TÂCHES的Claude Code设计。
claude-code context-engineering meta-prompting spec-driven-development
一句话总结
GSD 通过将繁重任务卸载到全新的子代理会话中,彻底解决了独立开发者的上下文腐化问题。
🔥 核心能力与独特卖点
- 六命令工作流循环 — 一个可重复的周期(初始化 → 讨论 → 计划 → 执行 → 验证 → 交付),彻底消除决策疲劳。每个命令只做一件事,你永远不用纠结"下一步该干嘛"。
- 并行子代理执行 — 计划以并行波次执行,每个任务都拥有全新的 200k Token 上下文和原子提交。这是解决上下文腐化的核心方案:你的主会话利用率维持在 30–40%,而繁重工作在干净环境中完成。
- 结构化共享内存 — 持久化产物(
PROJECT.md、REQUIREMENTS.md、ROADMAP.md、STATE.md、CONTEXT.md)跨越会话边界。关掉终端,明天回来,GSD 精准知道你停在哪里。 - 内置验证与调试代理 — 执行完成后,GSD 会审查构建内容,用专用调试代理诊断失败原因,并生成修复方案,然后才宣告阶段完成。再也别担心"在我会话里明明能跑"的意外。
- 多运行时支持 — 通过单一安装器,兼容 Claude Code、OpenCode、Gemini CLI、Kilo、Codex、Copilot、Cursor、Windsurf 等工具。切换工具时,你的工作流无需改变。
独特卖点: 与那些需要 Jira、冲刺仪式和团队配合的企业级规范驱动工具不同,GSD 专为独立开发者和小型团队设计,提供轻量、无摩擦的工作流,零额外负担。
技术架构
| 组件 | 描述 |
|---|---|
| 运行时 | JavaScript (Node.js),通过 npx 安装 |
| 编排引擎 | 多代理系统,配备专用子代理(研究员、规划师、执行者、验证者) |
| 上下文工程 | XML 提示格式化、子代理编排、状态管理 |
| 存储 | 基于文件的结构化内存(PROJECT.md、REQUIREMENTS.md、ROADMAP.md、STATE.md、CONTEXT.md) |
| 配置 | .planning/config.json,包含模式设置(交互式/yolo)、模型配置(高质量/均衡/经济)、工作流开关和并行化参数 |
| 安装 | 安装到运行时特定的技能目录(例如 ~/.claude/skills/gsd-*/) |
| Git 集成 | 每个任务拥有独立的原子提交,保持整洁的 Git 历史 |
快速入门指南
bash
# 安装并初始化 GSD(适用于 Claude Code)
npx get-shit-done-cc@latestbash
# 启动 Claude Code 并启用全自动化(需要 --dangerously-skip-permissions)
claude --dangerously-skip-permissionsbash
# 启动新项目
/gsd-new-projectbash
# 映射现有代码库(重新回到项目时使用)
/gsd-map-codebasebash
# 六命令工作流循环
/gsd-discuss-phase 1 # 讨论需要构建什么
/gsd-plan-phase 1 # 规划实现方案
/gsd-execute-phase 1 # 在并行子代理中执行计划
/gsd-verify-work 1 # 验证工作是否正确完成
/gsd-ship 1 # 交付已完成的阶段bash
# 里程碑管理
/gsd-complete-milestone # 标记当前里程碑已完成
/gsd-new-milestone # 启动新里程碑
/gsd-progress --next # 查看下一步计划bash
# 全局安装(自定义配置目录)
CLAUDE_CONFIG_DIR=/home/youruser/.claude npx get-shit-done-cc --global优点、缺点与使用场景
优点
- 解决上下文腐化 — 这是长时 AI 编码会话中最大的痛点,通过子代理编排优雅解决
- 轻量级 — 六个命令,无需 Jira、冲刺仪式、团队会议
- 跨运行时 — 兼容 Claude Code、Copilot、Cursor、Windsurf 等
- 无摩擦自动化 —
--dangerously-skip-permissions模式实现全自主执行 - 整洁的 Git 历史 — 每个任务的原子提交让回滚和代码审查变得轻而易举
缺点
- 全自动化需要
--dangerously-skip-permissions— 存在安全权衡,在某些环境中可能不可接受 - 上下文重建开销 — 回到项目需要先运行
/gsd-map-codebase,再运行/gsd-new-project来重建状态 - 专注于独立开发者/小型团队 — 不适合具有复杂访问控制、合规要求或大型分布式团队的企业组织
谁不应该使用?
- 企业团队 — 有严格的合规要求、多角色访问控制或现有项目管理工具链(Jira、Asana、Linear)
- 从不使用 AI 编码助手的开发者 — GSD 专为 AI 辅助开发工作流设计
- 需要实时协作的团队 — GSD 面向个人会话,不支持多用户并发编辑
- 需要人工代码审查关卡的项目 — 自动化模型假设对 AI 输出有信任
理想使用场景
- 独立开发者 — 使用 AI 辅助构建副项目、MVP 或个人工具
- 小型团队(2–5 人)— 使用 Claude Code 或 Copilot,希望有可重复工作流但不想增加仪式感
- 快速原型开发 — "讨论→计划→执行→验证→交付"循环非常适合快速迭代
- 开源维护者 — 希望在维护整洁提交历史的同时自动化日常开发任务
- AI 辅助代码库重构 — 全新的子代理上下文可在大规模变更中防止上下文污染
社区与活跃度
拥有 61,244 颗星,GSD 显然触动了开发者社区的神经。这不仅仅是一个小众工具——这是一场运动。该项目仍在积极维护(最后更新于 2026 年 5 月),其快速普及表明上下文腐化是许多开发者一直感受到却难以言表的痛点。跨运行时支持意味着它不依赖任何单一 AI 工具的命运,而活跃的开发状态预示着新功能和运行时集成即将到来。如果你正在用 AI 构建项目,却还没试过 GSD,那你正在浪费生产力。