GSD 使用指南：高效交付功能的结构化工作流

一、为什么需要 GSD？

你是否遇到过这些问题？

 “AI 写的代码前后不一致，改完 A 功能，B 功能就崩了”
 “上下文太长，生成质量断崖式下降”
 “每次都要重复解释项目结构、技术栈、编码规范”
 “想快速加功能，结果被问一堆无关问题”

GSD（GET SHIT DONE）就是为解决这些问题而生：

 原子化任务：每个功能拆成独立小任务，全新上下文执行，杜绝上下文衰减
 自动验证：每步生成可测试交付物，失败自动诊断修复
 状态记忆：通过 PROJECT.md、STATE.md 等文件持久化项目上下文

 核心理念：GSD 不是取代你，而是把你从重复劳动中解放出来，专注真正重要的设计与决策。

二、快速入门：我该从哪开始？

新手决策树（5 秒选对命令）

️ 前提：项目根目录已初始化 Git（GSD 依赖 git commit 追踪变更）

三、核心工作流：里程碑闭环

GSD 以里程碑（Milestone） 为单位组织开发。每个里程碑代表一个可交付的功能集，其完整流程如下：

1. 初始化项目

   • 全新项目：gsd-new-project

   • 已有代码：gsd-map-codebase → gsd-new-project

2. 创建里程碑

   gsd-new-milestone "用户登录"
   

   → 定义本次要完成的目标范围

3. 讨论阶段（关键！）

   gsd-discuss-phase 1
   

   • 系统提问：UI 风格？API 响应格式？错误处理方式？

   • 输出 CONTEXT.md，直接影响后续规划

   • 可随时输入 done 跳过剩余问题

4. 规划阶段（可人工干预！）

   gsd-plan-phase 1
   

   • 自动生成原子任务计划（存储于 .planning/phase-1/PLAN.md）

   • 如果你不认可计划：直接编辑 PLAN.md

   • 重新运行 gsd-execute-phase 1 即可生效

5. 执行阶段（全自动）

   gsd-execute-phase 1
   

   • 按依赖关系分“波次”（Wave）并行执行

   • 每个任务使用全新上下文，避免信息污染

   • 每完成一个任务 → 自动 git commit

6. 验证工作（人工兜底）

   gsd-verify-work 1
   

   • 系统列出可测试项：“你能用邮箱登录吗？”

   • 你回答 是 / 否 或描述问题

7. 里程碑管理（版本级闭环）
   当功能集完成时：

   # 检查是否达成目标
   gsd-audit-milestone
   
   # 若通过，归档并标记发布
   gsd-complete-milestone
   

   • gsd-complete-milestone 不会删除任何文件

   • 它将当前 .planning/ 归档到 .planning/archive/v1.0/，并生成发布日志

四、完整主干流程图

graph TD
    Start([开始]) --> Init{"项目类型"}
    Init -->|"新项目"| NewProj["gsd-new-project"]
    Init -->|"已有代码"| MapCode["gsd-map-codebase"]
    MapCode --> NewProj
    NewProj --> Setup["生成 PROJECT.md REQUIREMENTS.md .planning/"]
    Setup --> NewMile["gsd-new-milestone 功能名"]
    NewMile --> Discuss["gsd-discuss-phase N"]
    Discuss --> Context["输出 CONTEXT.md"]
    Context --> Plan["gsd-plan-phase N"]
    Plan --> Review{"是否认可计划"}
    Review -->|"是"| Execute["gsd-execute-phase N"]
    Review -->|"否"| EditPlan["手动编辑 PLAN.md"]
    EditPlan --> Execute
    Execute --> Verify{"人工验证是否通过"}
    Verify -->|"是"| Audit["gsd-audit-milestone"]
    Audit --> Done{"里程碑是否完成"}
    Done -->|"是"| Complete["gsd-complete-milestone"]
    Complete --> End([结束])

 逻辑顺序：先 gsd-new-project，再 gsd-new-milestone，然后进入阶段闭环。

五、高频命令速查制

六、总结：高效开发心法

• 用对流程：新功能走完整五步，小任务用 gsd-quick

• 信任但验证：必须执行 gsd-verify-work

• 敢于干预：不认可计划？直接编辑 PLAN.md！

• 闭环管理：用 gsd-complete-milestone 和 gsd-new-milestone 管理版本

 记住：GSD 给你掌控感，而非替代你。你可以全自动跑完全程，也可以在任何环节插手干预——它始终是你手中的工具。

官方仓库：gitcode.com/gh_mirrors/…