gsd-build / get-shit-done

gsd-build/get-shit-done

open_in_new前往仓库

一个轻量级且强大的元提示、上下文工程和规范驱动开发系统，专为TÂCHES的Claude Code设计。

项目概览

项目概述

GSD（Get Shit Done）是一个轻量级且功能强大的元提示（meta-prompting）、上下文工程（context engineering）和规范驱动开发（spec-driven development）系统，专为 Claude Code 等 AI 编码代理设计。它通过结构化的规划工件（如 PROJECT.md、ROADMAP.md、STATE.md）和多代理编排，将用户的想法转化为可执行的分阶段开发计划，并持续跟踪项目状态。该项目由 TÂCHES 开发，当前仓库已归档，开发已迁移至 Open GSD 仓库（https://github.com/open-gsd/gsd-core）。

核心功能

  • 元提示与上下文工程：通过精心设计的提示词和上下文工件，为 AI 代理提供每个任务所需的全部信息，减少上下文腐烂。
  • 规范驱动开发：从需求提取、研究、规划、执行到验证的完整流水线，确保每个阶段都有明确的目标和验收标准。
  • 多代理编排：薄编排器（workflow 文件）生成具有全新上下文窗口的专用代理（如 planner、executor、verifier），实现并行执行和高效协作。
  • 状态管理：所有状态以人类可读的 Markdown 和 JSON 文件形式存储在 .planning/ 目录中，支持跨会话和上下文重置的持久化。
  • 多运行时支持：支持 Claude Code、Gemini CLI、OpenCode、Codex、Copilot 等 15 种 AI 编码运行时，安装器自动转换命令、代理和钩子。
  • 丰富的命令集：提供 67 个斜杠命令（如 /gsd-new-project、/gsd-plan-phase、/gsd-execute-phase、/gsd-review 等），覆盖项目初始化、讨论、规划、执行、验证、审查、调试等全流程。
  • 安全与质量门禁：包括计划检查器、验证器、代码审查、安全审计、包合法性门禁（防 slopsquatting）等，确保交付质量。

适用与不适用场景

适用场景：

  • 使用 AI 编码代理（特别是 Claude Code）进行软件开发，希望提高开发效率和代码质量。
  • 需要结构化、可追踪的开发流程，从需求到交付的完整管理。
  • 个人开发者或小团队，希望利用 AI 辅助进行项目规划、执行和验证。
  • 需要跨会话保持项目上下文和状态的项目。

不适用场景：

  • 不需要 AI 辅助的传统软件开发流程。
  • 对开发流程有严格定制需求，且无法适应 GSD 的固定工作流。
  • 需要实时协作或复杂权限管理的团队项目（GSD 主要面向个人或小团队）。
  • 项目已使用其他成熟的规划工具，且不希望引入额外依赖。

技术架构与依赖

  • 语言：JavaScript（Node.js），核心库使用 CommonJS 模块。
  • 运行时：Node.js 22+（最低支持），Node 24 为主要 CI 目标。
  • 依赖：核心工具仅使用 Node.js 内置模块，无外部依赖；可选依赖包括 slopcheck（用于包合法性检查）、graphify（用于知识图谱）等。
  • 架构：命令层（commands/gsd/.md）→ 工作流层（workflows/.md）→ 代理层（agents/*.md）→ CLI 工具层（gsd-tools.cjs / gsd-sdk）→ 文件系统（.planning/）。
  • 安装：通过 npm 包 get-shit-done-cc 安装，支持全局或本地安装，并针对不同运行时进行适配。

安装与快速开始

安装：

# 全局安装（默认最新稳定版）
npm install -g get-shit-done-cc@latest

# 或使用 npx 一次性运行
npx get-shit-done-cc@latest

快速开始：

  1. 在项目目录中运行 /gsd-new-project，按照提示输入项目想法，系统将自动进行问题引导、研究、需求提取和路线图生成。
  2. 使用 /gsd-discuss-phase 讨论阶段细节，生成 CONTEXT.md。
  3. 使用 /gsd-plan-phase 生成执行计划（PLAN.md）。
  4. 使用 /gsd-execute-phase 执行计划，生成代码和提交。
  5. 使用 /gsd-verify-work 进行用户验收测试。

典型使用方法

  • 项目初始化：/gsd-new-project --auto @prd.md 从 PRD 文档自动提取项目信息。
  • 阶段讨论：/gsd-discuss-phase 1 讨论阶段 1 的细节。
  • 规划：/gsd-plan-phase 1 为阶段 1 生成计划。
  • 执行：/gsd-execute-phase 1 执行阶段 1 的所有计划。
  • 验证：/gsd-verify-work 1 进行用户验收测试。
  • 代码审查：/gsd-code-review 3 --fix 审查阶段 3 的代码并自动修复。
  • 自主运行：/gsd-autonomous 自动运行所有剩余阶段。
  • 跨 AI 审查：/gsd-review --phase 2 --all 使用所有可用审查器进行计划审查。

配置与部署要点

  • 配置文件：.planning/config.json 存储项目配置，包括工作流开关、模型配置文件、Git 分支策略等。
  • 模型配置：通过 model_profile（quality/balanced/budget/inherit）和 model_overrides 控制每个代理使用的模型。
  • 环境变量：如 CLAUDE_CONFIG_DIR、GSD_PROJECT 等可覆盖默认行为。
  • 部署：支持全局和本地安装，安装器自动适配不同运行时（Claude Code、Codex 等）。
  • 更新：使用 /gsd-update 检查并更新，支持 --sync 同步技能和 --reapply 重新应用本地补丁。

限制、风险与许可证

  • 限制：
    • 当前仓库已归档，开发已迁移至 Open GSD 仓库，新功能请关注新仓库。
    • 主要面向 Claude Code 等 AI 编码代理，对非 AI 开发流程支持有限。
    • 依赖 AI 代理的推理能力，输出质量受模型影响。
  • 风险：
    • 提示注入风险：用户输入可能包含恶意指令，GSD 提供了安全钩子（如 gsd-prompt-guard）进行检测，但并非绝对安全。
    • 包合法性风险：AI 可能推荐不存在的包，GSD 提供了包合法性门禁，但需要用户配合验证。
    • 上下文窗口限制：大型项目可能超出上下文窗口，需要合理配置。
  • 许可证：MIT 许可证。

官方链接

信息来源和分析时间

  • 信息来源：GitHub 仓库 README、CHANGELOG.md、CONTRIBUTING.md、docs/ 目录下的架构、命令、配置、功能等文档。
  • 分析时间：2026-05-16（基于最新发布 v1.42.3 的日期）。