🪴 Quartz 4.0

get-shit-done-分析指南

9 min read

Get Sh*t Done (GSD) 分析指南

命令速查

一表总览

命令类别干什么解决什么问题
核心工作流
/gsd:new-project🔴核心初始化项目从想法到可执行计划
/gsd:discuss-phase [N]🔴核心深入讨论阶段避免”做出来不一样”
/gsd:plan-phase [N]🔴核心创建可执行计划拆解任务，确定顺序
/gsd:execute-phase [N]🔴核心波次并行执行高效完成任务
/gsd:verify-work [N]🔴核心人工验收测试确保真的做好了
快速执行
/gsd:quick🟠常用快速任务+GSD保证临时需求不想走流程
/gsd:fast🟠常用最快执行简单任务直接搞定
/gsd:ship [N]🟠常用创建PR完成阶段后快速发版
/gsd:autonomous自动跑完所有完全放手让AI搞定
项目管理
/gsd:new-milestone启动下一版本v1完成→v1.1
/gsd:complete-milestone归档+标记发布收尾里程碑
/gsd:pause-work保存工作状态会话中断
/gsd:resume-work恢复工作从断点继续
阶段管理
/gsd:add-phase追加阶段roadmap扩展
/gsd:insert-phase [N]插入小数阶段紧急工作插队(72.1)
/gsd:remove-phase [N]删除阶段需求变更
导航/状态
/gsd:progress🟠常用查看进度现在在哪？
/gsd:next🟠常用自动下一步不需要记命令
/gsd:health检查状态完整性状态损坏早发现
/gsd:stats项目统计了解项目状况
代码质量
/gsd:review交叉AI评审外部视角审查
/gsd:audit-milestone验证里程碑完成确保交付完整
/gsd:audit-uat扫描未处理UAT追踪验证债务
上下文持久化
/gsd:thread [name]跨会话上下文跨session工作
/gsd:session-report会话报告了解工作历史
/gsd:pr-branch干净PR分支reviewer只看代码
Backlog/长期
/gsd:add-backlog添加parking lot暂时搁置想法
/gsd:review-backlog审查backlog定期清理
/gsd:plant-seed前瞻性想法正确时机浮现
工具类
/gsd:add-todo捕获todo临时想到的任务
/gsd:check-todos查看todos回顾待办
/gsd:note想法捕获零摩擦记录
/gsd:debug系统调试复杂问题定位
/gsd:forensics失败尸检问题根因分析
/gsd:do命令路由自然语言转命令
配置
/gsd:settings工作流配置个性化设置
/gsd:set-profile模型切换成本/质量平衡
/gsd:updateGSD更新保持最新
/gsd:map-codebase代码库分析理解现有项目

常见工作流

场景一：新项目（从零开始）

┌─────────────────────────────────────────────────────────────────┐
│  完整流程：idea → 规划 → 执行 → 验证 → 发版                    │
└─────────────────────────────────────────────────────────────────┘

# 1. 初始化项目（告诉 GSD 你想做什么）
/gsd:new-project

# GSD 会问：
#   - 你要做什么？
#   - 技术栈偏好？
#   - 有哪些约束？

# 2. 对阶段1进行深度讨论（推荐）
/gsd:discuss-phase 1
# 明确实现细节，避免做出来不一样

# 3. 规划阶段1
/gsd:plan-phase 1
# GSD 会研究技术方案，创建 PLAN.md

# 4. 执行阶段1
/gsd:execute-phase 1
# 波次并行执行，原子提交

# 5. 验收测试
/gsd:verify-work 1

# 6. 发版
/gsd:ship 1

场景二：已有代码库（Brownfield）

# 1. 先分析现有代码库
/gsd:map-codebase

# 2. 再初始化新功能
/gsd:new-project

场景三：快速任务

# 修复 bug
/gsd:quick "修复登录密码显示问题"

# 添加简单功能
/gsd:quick --discuss "添加暗黑模式"

# 最简单的情况
/gsd:fast "更新 README"

场景四：不知道下一步

/gsd:progress    # 查看状态
/gsd:next        # 自动下一步
/gsd:manager     # 交互式仪表盘（推荐）

场景五：会话中断/恢复

# 工作中断
/gsd:pause-work

# 恢复工作
/gsd:resume-work

常用命令组合

场景命令
新项目完整流程new-project → discuss 1 → plan 1 → execute 1 → verify 1 → ship 1
快速修复quick "具体描述"
查看状态progress 或 manager
下一步next
理解现有代码map-codebase

Auto Mode（懒人模式）

# 文档驱动，自动执行
/gsd:new-project --auto @prd.md

以下为详细分析

1. 项目概述

定位：为 AI 编程助手（Claude Code、OpenCode、Gemini CLI、Codex、Copilot）提供的 meta-prompting 和 context engineering 系统。

核心问题：解决 “context rot” — AI 上下文窗口填满后质量下降。

解决思路：

  • 复杂度在系统中，不在工作流中
  • 多 Agent 编排 + 波次并行执行
  • XML 格式任务定义 + 目标回溯验证
  • 原子 Git 提交保持可追溯性

2. 架构全景

命令层 (commands/gsd/) → 工作流层 (workflows/) → Agent 层 (agents/) → 核心库 (bin/lib/)
层级目录职责
命令层commands/gsd/用户入口，59 个命令
工作流层workflows/Markdown 状态机，~50 个工作流
Agent 层agents/17 个专业化子 Agent
核心库get-shit-done/bin/lib/Node.js 工具库

3. 核心流程图

3.1 主工作流

flowchart LR
    A["/gsd:new-project"] --> B["/gsd:discuss-phase"]
    B --> C["/gsd:plan-phase"]
    C --> D["/gsd:execute-phase"]
    D --> E["/gsd:verify-work"]
    E --> F["/gsd:ship"]
    F --> G["/gsd:complete-milestone"]
    
    style A fill:#e1f5fe
    style G fill:#c8e6c9

3.2 execute-phase 波次执行

flowchart LR
    subgraph WAVE1["WAVE 1 (parallel)"]
        P1["Plan 01<br/>User Model"]
        P2["Plan 02<br/>Product Model"]
    end
    
    subgraph WAVE2["WAVE 2 (parallel)"]
        P3["Plan 03<br/>Orders API"]
        P4["Plan 04<br/>Cart API"]
    end
    
    subgraph WAVE3["WAVE 3 (sequential)"]
        P5["Plan 05<br/>Checkout UI"]
    end
    
    P1 --> P3
    P2 --> P4
    P3 --> P5
    P4 --> P5
    
    style WAVE1 fill:#fff3e0
    style WAVE2 fill:#fff3e0
    style WAVE3 fill:#fce4ec

3.3 verify-work 目标回溯

flowchart TB
    G["Goal<br/>阶段目标"] --> T["Truths<br/>必须为真"]
    T --> A["Artifacts<br/>必须存在"]
    A --> L["Key Links<br/>必须连接"]
    
    L --> V["✓ VERIFIED"]
    L --> F["✗ FAILED"]
    L --> U["? UNCERTAIN"]
    
    style G fill:#e3f2fd
    style V fill:#c8e6c9
    style F fill:#ffcdd2
    style U fill:#fff9c4

3.4 架构层次

flowchart TB
    subgraph UI["用户界面"]
        CMD["59 个命令<br/>/gsd:xxx"]
    end
    
    subgraph Commands["命令层"]
        C1["new-project"]
        C2["discuss-phase"]
        C3["plan-phase"]
        C4["execute-phase"]
        C5["verify-work"]
    end
    
    subgraph Workflows["工作流层"]
        W1["new-project.md"]
        W2["discuss-phase.md"]
        W3["plan-phase.md"]
        W4["execute-phase.md"]
        W5["verify-work.md"]
    end
    
    subgraph Agents["Agent 层"]
        A1["planner"]
        A2["executor"]
        A3["verifier"]
        A4["researcher"]
        A5["debugger"]
    end
    
    subgraph Core["核心库"]
        K1["gsd-tools.cjs"]
        K2["state.cjs"]
        K3["security.cjs"]
        K4["init.cjs"]
    end
    
    CMD --> C1 & C2 & C3 & C4 & C5
    C1 --> W1
    C2 --> W2
    C3 --> W3
    C4 --> W4
    C5 --> W5
    W1 --> A1 & A4
    W3 --> A1 & A4 & A5
    W4 --> A2
    W5 --> A3 & A5
    W1 & W2 & W3 & W4 & W5 --> K1 & K2 & K3 & K4

4. 关键设计

4.1 多 Agent 编排

StageOrchestratorAgents
Research协调4 并行 researchers
Planning验证 + 迭代Planner + Checker
Execution分组 + 追踪Executors（并行）
Verification呈现 + 路由Verifier + Debuggers

4.2 Model Profiles

ProfilePlanningExecutionVerification
qualityOpusOpusSonnet
balancedOpusSonnetSonnet
budgetSonnetSonnetHaiku
inheritInheritInheritInherit

4.3 安全模块

// security.cjs 五大威胁
1. Path traversal    — validatePath()
2. Prompt injection  — INJECTION_PATTERNS
3. Shell injection   — sanitizeShellArg()
4. JSON injection    — validateFieldName()
5. Regex DoS         — safeRegex()

5. 设计思想

  1. 复杂度在系统中 — 用户只需命令，AI 搞定一切
  2. 计划即提示 — PLAN.md 直接作为 prompt
  3. 目标回溯 — 从期望结果验证，而非任务完成
  4. 波次优于并行 — 独立任务并行，依赖任务顺序
  5. 决策锁定 — discuss-phase 的决策不可覆盖

6. 文件索引

文件功能
gsd-tools.cjsCLI 工具主入口
core.cjs共享工具
state.cjsSTATE.md 操作
security.cjs安全检查
init.cjs初始化逻辑
Agent功能
gsd-planner创建可执行计划
gsd-executor执行 + 原子提交
gsd-verifier目标回溯验证
gsd-phase-researcher领域研究
gsd-plan-checker计划质量检查
gsd-debugger诊断 + 修复

Graph View

Backlinks

  • No backlinks found