\n
\n\n非交互式安装（Docker、CI、脚本）
\n\n```bash\n# Claude Code\nnpx get-shit-done-cc --claude --global # 安装到 ~/.claude/\nnpx get-shit-done-cc --claude --local # 安装到 ./.claude/\n\n# OpenCode\nnpx get-shit-done-cc --opencode --global # 安装到 ~/.config/opencode/\n\n# Gemini CLI\nnpx get-shit-done-cc --gemini --global # 安装到 ~/.gemini/\n\n# Kilo\nnpx get-shit-done-cc --kilo --global # 安装到 ~/.config/kilo/\nnpx get-shit-done-cc --kilo --local # 安装到 ./.kilo/\n\n# Codex\nnpx get-shit-done-cc --codex --global # 安装到 ~/.codex/\nnpx get-shit-done-cc --codex --local # 安装到 ./.codex/\n\n# Copilot\nnpx get-shit-done-cc --copilot --global # 安装到 ~/.github/\nnpx get-shit-done-cc --copilot --local # 安装到 ./.github/\n\n# Cursor CLI\nnpx get-shit-done-cc --cursor --global # 安装到 ~/.cursor/\nnpx get-shit-done-cc --cursor --local # 安装到 ./.cursor/\n\n# Antigravity\nnpx get-shit-done-cc --antigravity --global # 安装到 ~/.gemini/antigravity/\nnpx get-shit-done-cc --antigravity --local # 安装到 ./.agent/\n\n# Augment\nnpx get-shit-done-cc --augment --global # 安装到 ~/.augment/\nnpx get-shit-done-cc --augment --local # 安装到 ./.augment/\n\n# Trae\nnpx get-shit-done-cc --trae --global # 安装到 ~/.trae/\nnpx get-shit-done-cc --trae --local # 安装到 ./.trae/\n\n# CodeBuddy\nnpx get-shit-done-cc --codebuddy --global # 安装到 ~/.codebuddy/\nnpx get-shit-done-cc --codebuddy --local # 安装到 ./.codebuddy/\n\n# Cline\nnpx get-shit-done-cc --cline --global # 安装到 ~/.cline/\nnpx get-shit-done-cc --cline --local # 安装到 ./.clinerules\n\n# 所有运行时\nnpx get-shit-done-cc --all --global # 安装到所有目录\n```\n\n使用 `--global`（`-g`）或 `--local`（`-l`）可以跳过安装位置提示。\n使用 `--claude`、`--opencode`、`--gemini`、`--kilo`、`--codex`、`--copilot`、`--cursor`、`--windsurf`、`--antigravity`、`--augment`、`--trae`、`--codebuddy`、`--cline` 或 `--all` 可以跳过运行时提示。\n\n\n
\n\n### 推荐：跳过权限确认模式\n\nGSD 的设计目标是无摩擦自动化。运行 Claude Code 时建议使用：\n\n```bash\nclaude --dangerously-skip-permissions\n```\n\n> [!TIP]\n> 这才是 GSD 的预期用法。连 `date` 和 `git commit` 都要来回确认 50 次，整个体验就废了。\n\n开发安装
\n\n克隆仓库并在本地运行安装器：\n\n```bash\ngit clone https://github.com/gsd-build/get-shit-done.git\ncd get-shit-done\nnode bin/install.js --claude --local\n```\n\n这样会安装到 `./.claude/`，方便你在贡献代码前测试自己的改动。\n\n\n
\n\n---\n\n## 它是怎么工作的\n\n> **已经有现成代码库？** 先运行 `/gsd-map-codebase`。它会并行拉起多个代理分析你的技术栈、架构、约定和风险点。之后 `/gsd-new-project` 就会真正“理解”你的代码库，提问会聚焦在你打算新增的部分，规划时也会自动加载你的现有模式。\n\n### 1. 初始化项目\n\n```\n/gsd-new-project\n```\n\n一个命令，一条完整流程。系统会：\n\n1. **提问**：一直问到它彻底理解你的想法（目标、约束、技术偏好、边界情况）\n2. **研究**：并行拉起代理调研领域知识（可选，但强烈建议）\n3. **需求梳理**：提取哪些属于 v1、v2，哪些不在范围内\n4. **路线图**：创建与需求映射的阶段规划\n\n你审核并批准路线图后，就可以开始构建。\n\n**生成：** `PROJECT.md`、`REQUIREMENTS.md`、`ROADMAP.md`、`STATE.md`、`.planning/research/`\n\n---\n\n### 2. 讨论阶段\n\n```\n/gsd-discuss-phase 1\n```\n\n**这是你塑造实现方式的地方。**\n\n你的路线图里，每个阶段通常只有一两句话。这点信息不足以让系统按 *你脑中的样子* 把东西做出来。这一步的作用，就是在研究和规划之前，把你的偏好先收进去。\n\n系统会分析该阶段，并根据要构建的内容识别灰区：\n\n- **视觉功能**：布局、信息密度、交互、空状态\n- **API / CLI**：返回格式、flags、错误处理、详细程度\n- **内容系统**：结构、语气、深度、流转方式\n- **组织型任务**：分组标准、命名、去重、例外情况\n\n对每个你选择的区域，系统都会持续追问，直到你满意为止。最终产物 `CONTEXT.md` 会直接喂给后续两个步骤：\n\n1. **研究代理会读取它**：知道该研究哪些模式（例如“用户想要卡片布局” → 去研究卡片组件库）\n2. **规划代理会读取它**：知道哪些决策已经锁定（例如“已决定使用无限滚动” → 计划里就会包含滚动处理）\n\n你在这里给出的信息越具体，系统越能构建出你真正想要的东西。跳过它，你拿到的是合理默认值；用好它，你拿到的是 *你的* 方案。\n\n**生成：** `{phase_num}-CONTEXT.md`\n\n---\n\n### 3. 规划阶段\n\n```\n/gsd-plan-phase 1\n```\n\n系统会：\n\n1. **研究**：结合你的 `CONTEXT.md` 决策，调研这一阶段该怎么实现\n2. **制定计划**：创建 2-3 份原子化任务计划，使用 XML 结构\n3. **验证**：将计划与需求对照检查，直到通过为止\n\n每份计划都足够小，可以在一个全新的上下文窗口里执行。没有质量衰减，也不会出现“我接下来会更简洁一些”的退化状态。\n\n**生成：** `{phase_num}-RESEARCH.md`、`{phase_num}-{N}-PLAN.md`\n\n---\n\n### 4. 执行阶段\n\n```\n/gsd-execute-phase 1\n```\n\n系统会：\n\n1. **按 wave 执行计划**：能并行的并行，有依赖的顺序执行\n2. **每个计划使用新上下文**：20 万 token 纯用于实现，零历史垃圾\n3. **每个任务单独提交**：每项任务都有自己的原子提交\n4. **对照目标验证**：检查代码库是否真的交付了该阶段承诺的内容\n\n你可以离开，回来时看到的是已经完成的工作和干净的 git 历史。\n\n**Wave 执行方式：**\n\n计划会根据依赖关系被分组为不同的 “wave”。同一 wave 内并行执行，不同 wave 之间顺序推进。\n\n```\n┌─────────────────────────────────────────────────────────────────────┐\n│ PHASE EXECUTION │\n├─────────────────────────────────────────────────────────────────────┤\n│ │\n│ WAVE 1 (parallel) WAVE 2 (parallel) WAVE 3 │\n│ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │\n│ │ Plan 01 │ │ Plan 02 │ → │ Plan 03 │ │ Plan 04 │ → │ Plan 05 │ │\n│ │ │ │ │ │ │ │ │ │ │ │\n│ │ User │ │ Product │ │ Orders │ │ Cart │ │ Checkout│ │\n│ │ Model │ │ Model │ │ API │ │ API │ │ UI │ │\n│ └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │\n│ │ │ ↑ ↑ ↑ │\n│ └───────────┴──────────────┴───────────┘ │ │\n│ Dependencies: Plan 03 needs Plan 01 │ │\n│ Plan 04 needs Plan 02 │ │\n│ Plan 05 needs Plans 03 + 04 │ │\n│ │\n└─────────────────────────────────────────────────────────────────────┘\n```\n\n**为什么 wave 很重要：**\n- 独立计划 → 同一 wave → 并行执行\n- 依赖计划 → 更晚的 wave → 等依赖完成\n- 文件冲突 → 顺序执行，或合并到同一个计划里\n\n这也是为什么“垂直切片”（Plan 01：端到端完成用户功能）比“水平分层”（Plan 01：所有 model，Plan 02：所有 API）更容易并行化。\n\n**生成：** `{phase_num}-{N}-SUMMARY.md`、`{phase_num}-VERIFICATION.md`\n\n---\n\n### 5. 验证工作\n\n```\n/gsd-verify-work 1\n```\n\n**这是你确认它是否真的可用的地方。**\n\n自动化验证能检查代码存在、测试通过。但这个功能是否真的按你的预期工作？这一步就是让你亲自用。\n\n系统会：\n\n1. **提取可测试的交付项**：你现在应该能做到什么\n2. **逐项带你验证**：“能否用邮箱登录？” 可以 / 不可以，或者描述哪里不对\n3. **自动诊断失败**：拉起 debug 代理定位根因\n4. **创建验证过的修复计划**：可立刻重新执行\n\n如果一切通过，就进入下一步；如果哪里坏了，你不需要手动 debug，只要重新运行 `/gsd-execute-phase`，执行它自动生成的修复计划即可。\n\n**生成：** `{phase_num}-UAT.md`，以及发现问题时的修复计划\n\n---\n\n### 6. 重复 → 发布 → 完成 → 下一个里程碑\n\n```\n/gsd-discuss-phase 2\n/gsd-plan-phase 2\n/gsd-execute-phase 2\n/gsd-verify-work 2\n/gsd-ship 2 # 从已验证的工作创建 PR\n...\n/gsd-complete-milestone\n/gsd-new-milestone\n```\n\n或者让 GSD 自动判断下一步：\n\n```\n/gsd-progress --next # 自动检测并执行下一步\n```\n\n循环执行 **讨论 → 规划 → 执行 → 验证 → 发布**，直到整个里程碑完成。\n\n如果你希望在讨论阶段更快收集信息，可以用 `/gsd-discuss-phase 替代方案：细粒度权限
\n\n如果你不想使用这个 flag，可以在项目的 `.claude/settings.json` 中加入：\n\n```json\n{\n \"permissions\": {\n \"allow\": [\n \"Bash(date:*)\",\n \"Bash(echo:*)\",\n \"Bash(cat:*)\",\n \"Bash(ls:*)\",\n \"Bash(mkdir:*)\",\n \"Bash(wc:*)\",\n \"Bash(head:*)\",\n \"Bash(tail:*)\",\n \"Bash(sort:*)\",\n \"Bash(grep:*)\",\n \"Bash(tr:*)\",\n \"Bash(git add:*)\",\n \"Bash(git commit:*)\",\n \"Bash(git status:*)\",\n \"Bash(git log:*)\",\n \"Bash(git diff:*)\",\n \"Bash(git tag:*)\"\n ]\n }\n}\n```\n\n\n\n**Claude Code 很强，GSD 让它变得可靠。**\n\n
\n","readmeFilename":"README.zh-CN.md"}