## 项目概述

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` 安装，支持全局或本地安装，并针对不同运行时进行适配。

## 安装与快速开始

**安装：**
```bash
# 全局安装（默认最新稳定版）
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 仓库**：https://github.com/gsd-build/get-shit-done（已归档）
- **新仓库**：https://github.com/open-gsd/gsd-core
- **npm 包**：`get-shit-done-cc`（可通过 npm 搜索）
- **文档**：仓库内 `docs/` 目录包含完整文档（英文为主，部分翻译）。

## 信息来源和分析时间

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