npx get-shit-done-cc@latest

[!IMPORTANT]

欢迎回到 GSD

如果您在 Anthropic 最近更新服务条款后重返 GSD——欢迎回来！我们在您离开期间一直在持续开发。

要将现有项目重新导入 GSD：

1. 运行 /gsd-map-codebase 扫描并索引您当前代码库的状态
2. 运行 /gsd-new-project 使用代码库映射作为上下文初始化全新的 GSD 规划结构
3. 查阅 docs/USER-GUIDE.md 和 CHANGELOG，了解更新内容——自您上次使用以来，许多方面都发生了变化

您的代码并无问题。GSD 只需重建其规划上下文即可。上述两条命令即可完成这一操作。

我为何构建此项目

我是一名独立开发者。我不写代码——是 Claude Code 在帮我写。

市面上确实存在其他规范驱动的开发工具，比如 BMAD 和 Speckit……但它们往往让事情变得过于复杂（例如冲刺仪式、故事点、利益相关者同步会议、回顾会议、Jira 流程），或者缺乏对您正在构建的整体蓝图的深刻理解。我不是一家拥有 50 名员工的软件公司。我不想玩那些企业化的把戏。我只是一个富有创造力的人，只想打造出真正好用的好东西。

于是，我构建了 GSD。所有的复杂性都隐藏在系统内部，而不是您的工作流程中。后台运作包括上下文工程、XML 提示格式化、子代理编排和状态管理。而您看到的只是几个简单好用的命令。

这个系统为 Claude 提供了完成工作并验证结果所需的一切。我对这套流程充满信心——它确实能做好工作。

这就是它的本质：没有那些企业角色扮演式的废话，只有利用 Claude Code 持续高效地打造酷炫产品的强大系统。

— TÂCHES

Vibecoding 向来名声不佳。你描述自己的需求，AI 生成代码，结果却常常得到质量参差不齐、难以扩展的垃圾代码。

GSD 解决了这个问题。正是上下文工程层让 Claude Code 变得可靠。只需描述你的想法，让系统提取出所有必要的信息，然后交给 Claude Code 去执行。

适用人群

适合那些希望清晰表达自己的需求，并让系统正确实现它们的人——无需假装自己管理着一个拥有 50 名工程师的团队。

内置的质量门控能够及时发现真实问题：模式漂移检测会标记出遗漏迁移的 ORM 变更，安全强制措施会根据威胁模型进行验证，而范围缩减检测则可防止规划器悄悄忽略你的需求。

v1.37.0 亮点

• 快速探索与草图设计 — /gsd-spike 会运行 2–5 个以 Given/When/Then 形式呈现结果的重点实验；/gsd-sketch 则会针对每个设计问题生成 2–3 种交互式 HTML 原型方案——两者都会将成果存储在 .planning/ 目录下，并配合总结命令将这些发现打包成项目本地技能
• 代理规模与提示长度限制 — 分层级的行数上限（XL: 1600 行，Large: 1000 行，Default: 500 行）确保代理提示简洁精炼；任何超出限制的情况都会在 CI 中被标记出来
• 共享样板代码提取 — 强制初始读取和项目技能发现逻辑被提取到参考文件中，从而减少跨多个代理之间的重复代码

开始使用

npx get-shit-done-cc@latest

安装程序会提示您选择：

1. 运行时 — Claude Code、OpenCode、Gemini、Kilo、Codex、Copilot、Cursor、Windsurf、Antigravity、Augment、Trae、Qwen Code、CodeBuddy、Cline，或全部（交互式多选——可在一次安装中选择多个运行时）
2. 位置 — 全局（所有项目）或本地（仅当前项目）

验证方式如下：

• Claude Code / Gemini / Copilot / Antigravity / Qwen Code：/gsd-help
• OpenCode / Kilo / Augment / Trae / CodeBuddy：/gsd-help
• Codex：$gsd-help
• Cline：GSD 通过 .clinerules 安装——可通过检查 .clinerules 是否存在来验证。

[!注意] Claude Code 2.1.88+、Qwen Code 和 Codex 以技能形式安装（.claude/skills/、./.codex/skills/，或对应的全局 ~/.claude/skills/ / ~/.codex/skills/ 根目录）。较旧版本的 Claude Code 使用 commands/gsd/。~/.claude/get-shit-done/skills/ 仅用于旧版迁移的导入。安装程序会自动处理所有格式。

规范性的发现合约记录在 docs/skills/discovery-contract.md 中。

[!提示] 对于基于源码的安装或无法使用 npm 的环境，请参阅 docs/manual-update.md。

保持更新

GSD 发展迅速。请定期更新：

npx get-shit-done-cc@latest

# Claude Code
npx get-shit-done-cc --claude --global   # 安装到 ~/.claude/
npx get-shit-done-cc --claude --local    # 安装到 ./.claude/

# OpenCode
npx get-shit-done-cc --opencode --global # 安装到 ~/.config/opencode/

# Gemini CLI
npx get-shit-done-cc --gemini --global   # 安装到 ~/.gemini/

# Kilo
npx get-shit-done-cc --kilo --global     # 安装到 ~/.config/kilo/
npx get-shit-done-cc --kilo --local      # 安装到 ./.kilo/

# Codex
npx get-shit-done-cc --codex --global    # 安装到 ~/.codex/
npx get-shit-done-cc --codex --local     # 安装到 ./.codex/

# Copilot
npx get-shit-done-cc --copilot --global  # 安装到 ~/.github/
npx get-shit-done-cc --copilot --local   # 安装到 ./.github/

# Cursor CLI
npx get-shit-done-cc --cursor --global      # 安装到 ~/.cursor/
npx get-shit-done-cc --cursor --local       # 安装到 ./.cursor/

# Windsurf
npx get-shit-done-cc --windsurf --global    # 安装到 ~/.codeium/windsurf/
npx get-shit-done-cc --windsurf --local     # 安装到 ./.windsurf/

# Antigravity
npx get-shit-done-cc --antigravity --global # 安装到 ~/.gemini/antigravity/
npx get-shit-done-cc --antigravity --local  # 安装到 ./.agent/

# Augment
npx get-shit-done-cc --augment --global     # 安装到 ~/.augment/
npx get-shit-done-cc --augment --local      # 安装到 ./.augment/

# Trae
npx get-shit-done-cc --trae --global        # 安装到 ~/.trae/
npx get-shit-done-cc --trae --local         # 安装到 ./.trae/

# Qwen Code
npx get-shit-done-cc --qwen --global        # 安装到 ~/.qwen/
npx get-shit-done-cc --qwen --local         # 安装到 ./.qwen/

# CodeBuddy
npx get-shit-done-cc --codebuddy --global   # 安装到 ~/.codebuddy/
npx get-shit-done-cc --codebuddy --local    # 安装到 ./.codebuddy/

# Cline
npx get-shit-done-cc --cline --global       # 安装到 ~/.cline/
npx get-shit-done-cc --cline --local        # 安装到 ./.clinerules

# 所有运行时
npx get-shit-done-cc --all --global      # 安装到所有目录

git clone https://github.com/gsd-build/get-shit-done.git
cd get-shit-done
npm run build:hooks
node bin/install.js --claude --local

推荐：跳过权限模式

GSD 旨在实现无摩擦的自动化。运行 Claude Code 时使用以下命令：

claude --dangerously-skip-permissions

[!提示] 这正是 GSD 的设计初衷——如果每次都要停下来批准 date 和 git commit 操作，那就失去了自动化的意义。

{
  "permissions": {
    "allow": [
      "Bash(date:*)",
      "Bash(echo:*)",
      "Bash(cat:*)",
      "Bash(ls:*)",
      "Bash(mkdir:*)",
      "Bash(wc:*)",
      "Bash(head:*)",
      "Bash(tail:*)",
      "Bash(sort:*)",
      "Bash(grep:*)",
      "Bash(tr:*)",
      "Bash(git add:*)",
      "Bash(git commit:*)",
      "Bash(git status:*)",
      "Bash(git log:*)",
      "Bash(git diff:*)",
      "Bash(git tag:*)"
    ]
  }
}

工作原理

已有代码？ 首先运行 /gsd-map-codebase。它会启动并行代理来分析您的技术栈、架构、约定和关注点。然后 /gsd-new-project 就能了解您的代码库——问题将集中在您要添加的内容上，规划也会自动加载您的模式。

1. 初始化项目

/gsd-new-project

一条命令，一个流程。系统会执行以下步骤：

1. 提问 — 直到完全理解您的想法（目标、约束、技术偏好、边缘情况）
2. 研究 — 启动并行代理来调研领域（可选但推荐）
3. 需求 — 提取 v1、v2 以及不在范围内的内容
4. 路线图 — 根据需求创建阶段划分

您需批准路线图。现在您已准备好开始构建。

创建文件： PROJECT.md、REQUIREMENTS.md、ROADMAP.md、STATE.md、.planning/research/

2. 讨论阶段

/gsd-discuss-phase 1

在这里，您可以塑造实现方案。

您的路线图中每个阶段只有一两句话，这样的信息量不足以按照您设想的方式构建项目。这一步骤会在任何调研或规划开始之前，先收集您的偏好。

系统会分析当前阶段，并根据正在构建的内容识别出需要进一步明确的灰色地带：

• 视觉特性 → 布局、密度、交互、空状态
• API/CLI → 响应格式、标志位、错误处理、详细程度
• 内容系统 → 结构、语气、深度、流程
• 组织任务 → 分组标准、命名、重复项、例外情况

对于您选择的每个领域，系统都会持续提问，直到您满意为止。最终生成的 CONTEXT.md 文件将直接用于接下来的两个步骤：

1. 研究员阅读 — 了解需要调研哪些模式（例如“用户希望使用卡片布局”→ 调研卡片组件库）
2. 规划师阅读 — 知道哪些决策已经确定（例如“已决定使用无限滚动”→ 规划中包含滚动处理）

您在此阶段投入得越深入，系统构建出的结果就越符合您的预期。如果您跳过这一步，系统会提供合理的默认配置；而如果您充分利用它，则能实现您自己的愿景。

生成文件： {phase_num}-CONTEXT.md

假设模式： 更倾向于通过代码库分析来代替提问吗？请在 /gsd-settings 中将 workflow.discuss_mode 设置为 assumptions。系统会读取您的代码，展示它会如何操作以及原因，然后仅让您纠正其中不正确的地方。详情请参阅 讨论模式。

3. 规划阶段

/gsd-plan-phase 1

系统会执行以下操作：

1. 调研 — 根据您在 CONTEXT.md 中做出的决策，研究如何实现当前阶段
2. 规划 — 创建 2–3 个采用 XML 结构的原子级任务计划
3. 验证 — 对计划与需求进行核对，循环直至通过

每个计划都足够小，可以在全新的上下文中执行，不会出现效率下降或“我现在要更简洁一些”的情况。

生成文件： {phase_num}-RESEARCH.md, {phase_num}-{N}-PLAN.md

4. 执行阶段

/gsd-execute-phase 1

系统会执行以下操作：

1. 分波运行计划 — 在可能的情况下并行执行，有依赖关系时则按顺序执行
2. 每份计划独立上下文 — 每份计划拥有 20 万 token 的纯净上下文，不会累积冗余信息
3. 按任务提交 — 每个任务都会产生一次独立的提交
4. 对照目标验证 — 检查代码库是否实现了该阶段所承诺的功能

您可以暂时离开，稍后再回来查看已完成的工作，此时 Git 历史记录将是干净整洁的。

分波执行机制说明：

计划会根据依赖关系被分组为“波”。在同一波内，计划可以并行执行；不同波之间则按顺序依次执行。

┌────────────────────────────────────────────────────────────────────┐
│  阶段执行                                                         │
├────────────────────────────────────────────────────────────────────┤
│                                                                    │
│  波 1（并行）          波 2（并行）          波 3              │
│  ┌─────────┐ ┌─────────┐    ┌─────────┐ ┌─────────┐    ┌─────────┐ │
│  │ 计划 01 │ │ 计划 02 │ →  │ 计划 03 │ │ 计划 04 │ →  │ 计划 05 │ │
│  │         │ │         │    │         │ │         │    │         │ │
│  │ 用户    │ │ 产品    │    │ 订单    │ │ 购物车  │    │ 结账    │ │
│  │ 模型    │ │ 模型    │    │ API     │ │ API     │    │ UI      │ │
│  └─────────┘ └─────────┘    └─────────┘ └─────────┘    └─────────┘ │
│       │           │              ↑           ↑              ↑      │
│       └───────────┴──────────────┴───────────┘              │      │
│              依赖关系：计划 03 需要计划 01                      │      │
│                          计划 04 需要计划 02                    │      │
│                          计划 05 需要计划 03 和 04               │      │
│                                                                    │
└────────────────────────────────────────────────────────────────────┘

为什么分波很重要：

• 独立的计划 → 同一波 → 并行执行
• 有依赖关系的计划 → 后续波 → 等待依赖完成
• 文件冲突 → 串行执行或合并到同一计划中

这就是为什么“垂直切片”（计划 01：用户功能端到端）比“水平分层”（计划 01：所有模型，计划 02：所有 API）更能实现并行化的原因。

生成文件： {phase_num}-{N}-SUMMARY.md, {phase_num}-VERIFICATION.md

5. 验证工作

/gsd-verify-work 1

在这里，您可以确认功能是否真正可用。

自动化验证会检查代码是否存在以及测试是否通过。但功能是否真的如您预期般运作呢？这正是您亲自体验的机会。

系统会执行以下操作：

1. 提取可测试的交付成果 — 您现在应该能够完成的操作
2. 逐一引导您进行验证 — “您能否使用邮箱登录？”是/否，或者描述具体问题
3. 自动诊断失败原因 — 启动调试代理以查找根本原因
4. 创建已验证的修复计划 — 可立即重新执行

如果一切顺利，即可进入下一步；若发现问题，无需手动调试，只需再次运行 /gsd-execute-phase，使用系统生成的修复计划即可。

生成文件： {phase_num}-UAT.md, 若发现问题则生成修复计划

6. 重复 → 发布 → 完成 → 下一里程碑

/gsd-discuss-phase 2
/gsd-plan-phase 2
/gsd-execute-phase 2
/gsd-verify-work 2
/gsd-ship 2                  # 从已验证的工作中创建 PR
...
/gsd-complete-milestone
/gsd-new-milestone

或者让 GSD 自动决定下一步：

/gsd-next                    # 自动检测并执行下一步

循环执行 讨论 → 规划 → 执行 → 验证 → 发布，直到里程碑完成。

如果您希望在讨论阶段加快输入速度，可以使用 /gsd-discuss-phase <n> --batch 来一次性回答一组相关问题，而不是逐个回答。使用 --chain 参数可以将讨论自动连接到规划和执行步骤，无需在各步骤间停顿。

每个阶段都需要您的参与（讨论）、充分的调研（规划）、干净的执行（执行）以及人工验证（验证）。这样可以保持上下文的新鲜度，确保高质量的产出。

当所有阶段完成后，/gsd-complete-milestone 会归档该里程碑并标记发布版本。

随后，/gsd-new-milestone 将启动下一个版本——其流程与新建项目相同，只是针对现有代码库。您只需描述接下来想要构建的内容，系统会调研相关领域、梳理需求范围，并生成一份新的路线图。每个里程碑都是一个完整的闭环：定义 → 构建 → 发布。

快速模式

/gsd-quick

适用于无需全面规划的临时性任务。

快速模式在提供 GSD 保障（原子提交、状态跟踪）的同时，还采用了更快速的路径：

• 相同代理 — 计划者与执行者合一，质量不变
• 跳过可选步骤 — 默认不进行调研、计划检查和验证
• 独立跟踪 — 存在于 .planning/quick/ 目录下，而非分阶段目录中

--discuss 标志： 轻量级讨论，在规划前揭示潜在模糊点。

--research 标志： 在规划前启动一名专注的研究员。研究实现方案、库选项及常见陷阱。当您不确定如何着手时使用。

--full 标志： 启用所有阶段——讨论 + 调研 + 计划检查 + 验证。以快速任务形式运行完整的 GSD 流程。

--validate 标志： 仅启用计划检查 + 执行后验证（即之前的 --full 行为）。

标志可组合使用：--discuss --research --validate 将提供讨论 + 调研 + 计划检查 + 验证。

/gsd-quick
> 您想做什么？“在设置中添加暗黑模式切换”

创建： .planning/quick/001-add-dark-mode-toggle/PLAN.md, SUMMARY.md

为何有效

上下文工程

Claude Code 只有在获得所需上下文时才会表现出强大的能力。然而大多数人并未做到这一点。

GSD 会为您处理好这一切：

遵循 Claude 质量下降的大小限制。保持在范围内，即可获得持续卓越的表现。

XML 提示格式化

每个计划都采用针对 Claude 优化的结构化 XML 格式：

<task type="auto">
  <name>创建登录接口</name>
  <files>src/app/api/auth/login/route.ts</files>
  <action>
    使用 jose 库生成 JWT（而非 jsonwebtoken，因存在 CommonJS 问题）。
    对用户表中的凭据进行验证。
    成功时返回 httpOnly Cookie。
  </action>
  <verify>使用 curl -X POST localhost:3000/api/auth/login 发送请求，应返回 200 状态码及 Set-Cookie 头。</verify>
  <done>有效凭据返回 Cookie，无效则返回 401 错误。</done>
</task>

精确指令，无需猜测，内置验证机制。

多代理编排

每个阶段均采用相同模式：一个轻量级编排器会启动专门的代理，收集结果并传递至下一步。

编排器本身并不承担繁重工作。它负责启动代理、等待结果并整合反馈。

效果： 您可以完成整个阶段的工作——深入调研、创建并验证多个计划、由多组执行者并行编写数千行代码、自动验证是否符合目标——而您的主上下文窗口始终保持在 30%-40% 左右。实际工作是在全新的子代理上下文中进行的。因此，您的会话始终保持流畅响应。

原子级 Git 提交

每个任务完成后都会立即生成独立的提交：

abc123f docs(08-02): 完成用户注册计划
def456g feat(08-02): 添加邮箱确认流程
hij789k feat(08-02): 实现密码哈希功能
lmn012o feat(08-02): 创建注册接口

[!NOTE] 好处： Git bisect 可精准定位出错的任务。每个任务均可独立回滚。为 Claude 在后续会话中提供清晰的历史记录。在 AI 自动化工作流中提升可观测性。

每个提交都精准、可追溯且具有明确意义。

模块化设计

• 可向当前里程碑添加新阶段
• 可在各阶段之间插入紧急任务
• 可完成现有里程碑并重新开始
• 可调整计划而不必从头构建

您永远不会被锁定。系统能够灵活适应。

命令

核心工作流

工作流

多项目工作区

突击开发与草图绘制

UI 设计

导航

老系统改造

阶段管理

会话

工作流

代码质量

待办事项与线程

实用工具

^{¹ 由 Reddit 用户 OracleGreyBeard 贡献}

配置

GSD 将项目设置存储在 .planning/config.json 中。可在 /gsd-new-project 期间配置，或之后使用 /gsd-settings 进行更新。有关完整配置架构、工作流开关、Git 分支选项以及各代理的模型细分，请参阅用户指南。

核心设置

模型配置文件

控制每个代理使用的 Claude 模型。平衡质量与 Token 消耗。

切换配置文件：

/gsd-set-profile budget

当使用非 Anthropic 提供商（OpenRouter、本地模型）或希望遵循当前运行时模型选择时（例如 OpenCode /model），请使用 inherit 配置文件。

也可以通过 /gsd-settings 进行配置。

工作流代理

这些代理会在规划/执行过程中生成额外的代理。它们可以提高质量，但也会增加 Token 消耗和时间成本。

可通过 /gsd-settings 切换这些设置，或在每次调用时覆盖：

• /gsd-plan-phase --skip-research
• /gsd-plan-phase --skip-verify

执行

代理技能

在执行过程中将项目特定的技能注入到子代理中。

技能以 <agent_skills> 块的形式注入到代理提示中，使子代理能够访问项目特定的知识。

Git 分支策略

控制 GSD 在执行过程中如何处理分支。

策略：

• none — 提交到当前分支（GSD 默认行为）
• phase — 每个阶段创建一个分支，并在阶段完成后合并
• milestone — 为整个里程碑创建一个分支，并在完成时合并

在里程碑完成时，GSD 提供压缩合并（推荐）或保留历史记录的合并方式。

安全性

内置安全加固

自 v1.27 起，GSD 包含纵深防御的安全措施：

• 路径遍历防护 — 所有用户提供的文件路径（--text-file、--prd）都会被验证，确保解析后位于项目目录内
• 提示注入检测 — 中央化的 security.cjs 模块会在用户输入文本进入规划工件之前，扫描其中是否存在注入模式
• PreToolUse 提示保护钩子 — gsd-prompt-guard 会扫描 .planning/ 目录中的写入内容，查找嵌入式注入向量（仅作为建议，不会阻止操作）
• 安全 JSON 解析 — 格式错误的 --fields 参数会在破坏状态之前被捕获
• Shell 参数验证 — 用户输入的文本会在进行 Shell 插值之前被清理
• 适用于 CI 的注入扫描器 — prompt-injection-scan.test.cjs 会扫描所有代理/工作流/命令文件，查找其中是否含有嵌入式的注入向量

[!注意] 由于 GSD 会生成 Markdown 文件并将其用作 LLM 系统提示，任何由用户控制并流入规划工件的文本都可能成为间接的提示注入向量。这些保护措施旨在多层捕获此类向量。

保护敏感文件

GSD 的代码库映射和分析命令会读取文件以了解您的项目。请通过将包含密钥的文件添加到 Claude Code 的拒绝列表来保护它们：

1. 打开 Claude Code 设置（.claude/settings.json 或全局设置）
2. 将敏感文件模式添加到拒绝列表：

{
  "permissions": {
    "deny": [
      "Read(.env)",
      "Read(.env.*)",
      "Read(**/secrets/*)",
      "Read(**/*credential*)",
      "Read(**/*.pem)",
      "Read(**/*.key)"
    ]
  }
}

这将完全阻止 Claude 读取这些文件，无论您运行什么命令。

[!重要提示] GSD 内置了防止提交密钥的保护机制，但纵深防御才是最佳实践。将敏感文件设置为只读权限是第一道防线。

故障排除

安装后找不到命令？

• 重启运行时以重新加载命令和技能
• 对于全局安装，检查 ~/.claude/skills/gsd-*/SKILL.md 或 ~/.codex/skills/gsd-*/SKILL.md 是否存在
• 对于本地安装，检查 .claude/skills/gsd-*/SKILL.md 或 ./.codex/skills/gsd-*/SKILL.md 是否存在
• 旧版 Claude Code 安装仍使用 ~/.claude/commands/gsd/

命令无法按预期工作？

• 运行 /gsd-help 验证安装是否正确
• 重新运行 npx get-shit-done-cc 进行重新安装

更新到最新版本？

npx get-shit-done-cc@latest

使用 Docker 或容器化环境？

如果使用波浪线路径（~/.claude/...）时文件读取失败，请在安装前设置 CLAUDE_CONFIG_DIR：

CLAUDE_CONFIG_DIR=/home/youruser/.claude npx get-shit-done-cc --global

这样可以确保使用绝对路径，而不是可能在容器中无法正确展开的 ~ 符号。

卸载

要彻底移除 GSD：

# 全局安装
npx get-shit-done-cc --claude --global --uninstall
npx get-shit-done-cc --opencode --global --uninstall
npx get-shit-done-cc --gemini --global --uninstall
npx get-shit-done-cc --kilo --global --uninstall
npx get-shit-done-cc --codex --global --uninstall
npx get-shit-done-cc --copilot --global --uninstall
npx get-shit-done-cc --cursor --global --uninstall
npx get-shit-done-cc --windsurf --global --uninstall
npx get-shit-done-cc --antigravity --global --uninstall
npx get-shit-done-cc --augment --global --uninstall
npx get-shit-done-cc --trae --global --uninstall
npx get-shit-done-cc --qwen --global --uninstall
npx get-shit-done-cc --codebuddy --global --uninstall
npx get-shit-done-cc --cline --global --uninstall

# 本地安装（当前项目）
npx get-shit-done-cc --claude --local --uninstall
npx get-shit-done-cc --opencode --local --uninstall
npx get-shit-done-cc --gemini --local --uninstall
npx get-shit-done-cc --kilo --local --uninstall
npx get-shit-done-cc --codex --local --uninstall
npx get-shit-done-cc --copilot --local --uninstall
npx get-shit-done-cc --cursor --local --uninstall
npx get-shit-done-cc --windsurf --local --uninstall
npx get-shit-done-cc --antigravity --local --uninstall
npx get-shit-done-cc --augment --local --uninstall
npx get-shit-done-cc --trae --local --uninstall
npx get-shit-done-cc --qwen --local --uninstall
npx get-shit-done-cc --codebuddy --local --uninstall
npx get-shit-done-cc --cline --local --uninstall

此命令将移除所有 GSD 命令、代理、钩子和设置，同时保留您的其他配置。

社区移植版

OpenCode、Gemini CLI、Kilo 和 Codex 现在已通过 npx get-shit-done-cc 得到原生支持。

这些社区移植版率先实现了多运行时支持：

星标历史

许可证

MIT 许可证。详情请参阅 LICENSE。

get-shit-done 快速上手指南

get-shit-done (GSD) 是一个轻量级但功能强大的元提示（meta-prompting）、上下文工程和规范驱动开发系统。它专为 Claude Code、OpenCode、Gemini CLI、Cursor 等 AI 编程工具设计，旨在解决“上下文腐烂”问题，确保 AI 在长对话中依然能保持高质量的代码输出。

环境准备

在开始之前，请确保你的开发环境满足以下要求：

• 操作系统：macOS、Windows 或 Linux。
• Node.js：已安装 Node.js 和 npm（推荐最新 LTS 版本），因为该工具通过 npx 运行。
• AI 编程工具：已安装并配置好以下任一工具：
  • Claude Code (推荐)
  • OpenCode, Gemini CLI, Kilo, Codex
  • GitHub Copilot, Cursor, Windsurf
  • Antigravity, Augment, Trae, Qwen Code, Cline, CodeBuddy
• 网络环境：由于需要从 npm 注册表下载包，请确保网络畅通。如果访问 npm 较慢，建议配置国内镜像源（如淘宝镜像）：

  npm config set registry https://registry.npmmirror.com
  

安装步骤

GSD 提供交互式安装向导，可自动检测并配置支持的 AI 工具。

1. 运行安装命令

在终端中执行以下命令启动安装程序：

npx get-shit-done-cc@latest

2. 配置选项

安装程序会引导你完成两个关键选择：

1. 选择运行时 (Runtime)：
   • 使用方向键和空格键多选你需要集成的 AI 工具（例如：Claude Code, Cursor, Gemini 等）。
   • 选择 all 可一次性安装所有支持的工具。
2. 选择安装位置 (Location)：
   • Global (全局)：对所有项目生效（推荐）。
   • Local (局部)：仅对当前项目目录生效。

3. 验证安装

安装完成后，根据你的 AI 工具类型，在对应的聊天窗口或命令行中输入以下命令进行验证：

• Claude Code / Gemini / Copilot / Cursor 等:

  /gsd-help
  

• Codex:

  $gsd-help
  

• Cline: 检查项目根目录下是否已生成 .clinerules 文件。

注意：如果你使用的是旧版 Claude Code，命令可能位于 commands/gsd/ 目录下，新版通常安装在 .claude/skills/ 中。安装脚本会自动处理这些路径差异。

4. 推荐配置：跳过权限确认

为了获得流畅的自动化体验，避免 AI 在执行 git commit 或读取文件时频繁请求权限，建议在运行 AI 工具时添加跳过权限标志：

claude --dangerously-skip-permissions

如果不希望全局跳过权限，可以在项目的 .claude/settings.json 中手动添加允许的 Bash 命令列表（如 git add, git commit, ls, cat 等）。

基本使用

GSD 的核心工作流是通过简单的指令让 AI 理解你的意图并规划执行。

场景一：已有代码库，想要新增功能

如果你的项目中已经存在代码，首先需要让 GSD 扫描并建立上下文索引。

1. 扫描代码库： 在 AI 对话框中输入：

   /gsd-map-codebase
   

   系统会并行启动代理分析你的技术栈、架构模式和现有约定。

2. 初始化新项目规划： 扫描完成后，输入：

   /gsd-new-project
   

   AI 会基于扫描结果向你提问，以明确新功能的目标、约束和技术偏好，随后生成详细的需求文档和路线图。

场景二：从零开始新项目

直接输入初始化命令：

/gsd-new-project

系统将引导你完成以下流程：

1. 需求澄清：AI 会不断提问直到完全理解你的想法（目标、边界情况、技术选型）。
2. 领域研究：可选步骤，启动代理调研相关领域最佳实践。
3. 需求提取：自动区分 v1 核心功能、v2 规划及范围外内容。
4. 路线图生成：创建分阶段开发计划。

进阶技巧：快速实验与原型

• 技术探针 (Spike)：针对不确定的技术方案进行快速实验。

  /gsd-spike
  

  运行 2-5 次聚焦实验，并给出明确的结论。

• 设计草图 (Sketch)：针对 UI/UX 问题生成交互式 HTML 原型。

  /gsd-sketch
  

  为每个设计问题生成 2-3 个变体供选择。

提示：GSD 更新频繁，建议定期运行 npx get-shit-done-cc@latest 以保持最新版本。