🚀 一眼入口 >>>

⚡ 最小工作流 >>>

/gsd:new-project                  # 初始化项目
/gsd:discuss-phase 1             # 捕获实施决策
/gsd:plan-phase 1                # 研究 + 规划 + 验证
/gsd:execute-phase 1              # 波次并行执行
/gsd:verify-work 1                # 人工验收测试
/gsd:ship 1                      # 从验证工作创建 PR
/gsd:complete-milestone           # 归档里程碑，标记发布
/gsd:new-milestone                # 开始下一版本

/gsd:quick "添加深色模式切换"     # 立即执行
/gsd:quick --full "修复登录 bug"  # 含讨论 + 研究 + 验证

🚀 全新项目初始化 >>>

• /gsd:new-project [--auto]：启动新建项目流程

# 交互模式
/gsd:new-project
# 描述：我想做一个天气应用，用 Vue + Vite

# 自动模式（跳过确认）
/gsd:new-project --auto

🗺️ 代码库分析 >>>

• /gsd:map-codebase [area]：并行分析现有代码库

# 先分析代码库，再新建项目
/gsd:map-codebase
/gsd:new-project

💬 Discuss Phase >>>

• /gsd:discuss-phase [N] [--auto] [--analyze] [--chain]

/gsd:discuss-phase 1
# 选择关注的领域，回答问题

/gsd:discuss-phase 1 --analyze
# 添加 trade-off 分析

/gsd:discuss-phase 1 --chain
# 自动进入规划和执行，无需手动推进

📋 Plan Phase >>>

• /gsd:plan-phase [N] [--auto] [--reviews]

/gsd:plan-phase 1
# 输出：{phase_num}-RESEARCH.md, {phase_num}-{N}-PLAN.md

⚙️ Execute Phase >>>

• /gsd:execute-phase <N>

/gsd:execute-phase 1
# 输出：{phase_num}-{N}-SUMMARY.md, {phase_num}-VERIFICATION.md

✅ Verify Work >>>

• /gsd:verify-work [N]

/gsd:verify-work 1
# 输出：{phase_num}-UAT.md，若有问题则创建修复计划

🚢 Ship & Milestone >>>

/gsd:ship 1 [--draft]          # 从验证工作创建 PR
/gsd:complete-milestone         # 归档里程碑，标记发布
/gsd:new-milestone [name]      # 开始下一版本
/gsd:audit-milestone           # 验证里程碑是否达成
/gsd:milestone-summary [version] # 生成项目总结，用于团队 onboarding

⚡ 快速模式 >>>

• /gsd:quick [text] [--full] [--validate] [--discuss] [--research]

/gsd:quick "添加深色模式切换"       # 最快路径

/gsd:quick "修复登录 bug" --full    # 完整验证

/gsd:quick "重构用户模块" --discuss --research  # 带研究和讨论

🌊 Workstreams >>>

/gsd:workstreams list                    # 显示所有 workstream
/gsd:workstreams create <name>           # 创建新的 namespaced workstream
/gsd:workstreams switch <name>          # 切换 active workstream
/gsd:workstreams complete <name>         # 完成并合并 workstream

🏗️ Workspaces >>>

/gsd:new-workspace                        # 创建隔离 workspace（含 repo 副本）
/gsd:list-workspaces                      # 显示所有 workspace 及状态
/gsd:remove-workspace <name>              # 移除 workspace 并清理 worktrees

🎨 UI 设计 >>>

/gsd:ui-phase [N]                         # 为前端阶段生成 UI-SPEC.md
/gsd:ui-review [N]                       # 回顾性 6-pillar 视觉审计

🔍 代码质量 >>>

/gsd:review                               # 跨 AI peer review 当前阶段或分支
/gsd:secure-phase [N]                     # 基于威胁模型的安全验证
/gsd:pr-branch                            # 创建过滤 .planning/ 提交的 PR 分支
/gsd:audit-uat                            # 审计缺少 UAT 的阶段
/gsd:docs-update                          # 经验证的文件生成（doc-writer + doc-verifier）

📌 Backlog & Threads >>>

/gsd:plant-seed <idea>                    # 捕获前瞻性想法，带触发条件
/gsd:add-backlog <desc>                   # 添加到 backlog 停车场（999.x 编号）
/gsd:review-backlog                       # 审查并提升 backlog 项到 active milestone
/gsd:thread [name]                        # 持久化上下文线程，跨会话轻量级知识

💾 会话管理 >>>

/gsd:pause-work                          # 创建交接文档以便暂停
/gsd:resume-work                         # 恢复上次会话
/gsd:session-report                      # 生成会话总结，含完成的工作和结果

🔎 诊断与统计 >>>

/gsd:forensics [desc]                    # 失败工作流的事后调查（诊断 stuck loops、缺失 artifacts、git 异常）
/gsd:health [--repair]                   # 验证 .planning/ 目录完整性
/gsd:stats                               # 显示项目统计：阶段、计划、需求、git 指标
/gsd:debug [desc]                       # 系统性调试，带持久状态

🧭 导航与帮助 >>>

/gsd:progress                            # 查看当前位置和下一步
/gsd:next                                # 自动检测状态并运行下一步
/gsd:manager                             # 交互式命令中心，管理多阶段
/gsd:help                                # 显示所有命令和使用指南
/gsd:update                              # 更新 GSD，预览变更日志
/gsd:join-discord                        # 加入 GSD Discord 社区

🤖 Model Profiles >>>

🤝 Workflow Agents >>>

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

🌊 波次执行 >>>

WAVE 1 (并行)           WAVE 2 (并行)         WAVE 3
┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐
│ Plan 01 │ │ Plan 02 │ → Plan 03 │ │ Plan 04 │ → Plan 05 │
│  用户    │ │ 产品    │   订单    │ │购物车   │   结账   │
└─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘
    │           │             ↑           ↑             ↑
    └───────────┴─────────────┴───────────┘─────────────┘
                  依赖关系：Plan 03 依赖 Plan 01

📦 原子提交 >>>

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

🌿 Git Branching >>>

{
  "git": {
    "branching_strategy": "phase",
    "phase_branch_template": "gsd/phase-{phase}-{slug}",
    "milestone_branch_template": "gsd/{milestone}-{slug}"
  }
}

🛡️ 安全设置 >>>

• 路径遍历防护 — 验证所有用户提供的文件路径在项目目录内
• security.cjs
• gsd-prompt-guard .planning/
• --fields

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

🚀 推荐使用方式 >>>

claude --dangerously-skip-permissions

⚙️ 支持的运行时 >>>

npx get-shit-done-cc --claude --global   # Claude Code
npx get-shit-done-cc --opencode --global # OpenCode
npx get-shit-done-cc --gemini --global   # Gemini CLI
npx get-shit-done-cc --codex --global    # Codex
npx get-shit-done-cc --copilot --global  # GitHub Copilot
npx get-shit-done-cc --cursor --global   # Cursor CLI
npx get-shit-done-cc --windsurf --global # Windsurf
npx get-shit-done-cc --antigravity --global # Antigravity
npx get-shit-done-cc --all --global      # 全部运行时

🔧 故障排除 >>>

• 安装后命令不工作？重启运行时以重新加载命令
• /gsd:help
• npx get-shit-done-cc@latest
• CLAUDE_CONFIG_DIR：设置 环境变量

# Docker 环境中
CLAUDE_CONFIG_DIR=/home/youruser/.claude npx get-shit-done-cc --global

npx get-shit-done-cc --<runtime> --global --uninstall