Skill 学习篇（五）| 编排框架 · GSD 专篇

Skill 学习篇五| 编排框架 · GSD 专篇1. 一句话定义2. 它解决了什么问题3. 概览4. 核心亮点4.1 六命令工作流4.2 子代理编排4.3 持久化工件4.4 跨平台5. 安装方式方式一用 npx 装支持平台macOS / Linux / Windows6. 实战示例用 GSD 开发一个 CLI 待办事项工具7. 优点 缺点1. 一句话定义GSDGet Shit Done是一个专治上下文腐烂的编排框架。它不给你加技能而是给你一套工作流协议——把项目拆成多个阶段每个阶段开一个全新的 200K token 上下文窗口让子代理执行主窗口始终保持 30-40% 的低水位。关掉会话明天接着干质量不降。和技能包的区别技能包给你能力GSD 给你流程管理解决一个会话干到底、越干越差的问题。2. 它解决了什么问题用过 AI 编程的人都会遇到同一个会话用久了AI 输出质量明显下降。上下文窗口被填满早期的需求被挤掉AI 开始失忆。这就是上下文腐烂context rot——编排框架要解决的核心问题。GSD 的解法很简单不依赖一个超长会话而是每个阶段开新窗口。做完规划关掉开新窗口执行执行完验证再开新窗口验证。每个子任务都是满血状态。3. 概览项目数据仓库github.com/gsd-build/get-shit-doneStars60.5K分叉5.1K许可证MIT作者TÂCHESLex Christopherson最新版本v1.41.02026-05GSD 是专门为马拉松式项目设计的——那些需要做好几天的、中间会反复开关会话的长期任务。4. 核心亮点4.1 六命令工作流GSD 把开发过程标准化为 6 个命令每个命令对应一个独立阶段命令阶段做什么/gsd-new-project初始化创建项目骨架生成需求文档/gsd-plan-phase规划分析当前阶段要做什么、怎么做/gsd-execute-phase执行开子代理执行任务可并行/gsd-verify-work验证验证成果含专用调试代理/gsd-ship交付合并、提交、发布/gsd-resume恢复从上次中断的地方继续4.2 子代理编排GSD 的核心机制每个子任务开一个全新的上下文窗口。执行/gsd-execute-phase时GSD 会生成子代理每个子代理拥有独立的 200K token 上下文。不依赖的任务可以并行执行。主窗口只负责调度和汇总结果不会被实现细节填满。4.3 持久化工件项目全程在文件系统中维护这些文档不怕/clear、不怕关窗口PROJECT.md— 项目总览REQUIREMENTS.md— 需求规格ROADMAP.md— 路线图STATE.md— 当前进度状态CONTEXT.md— 跨会话上下文记忆今天干到一半关掉明天/gsd-resume接着干所有状态都在。4.4 跨平台支持 Claude Code、OpenCode、Gemini CLI、Kilo、Codex、Copilot、Cursor、Windsurf 等 15 运行时。5. 安装方式方式一用 npx 装支持平台macOS / Linux / Windows终端执行npx get-shit-done-cclatest安装过程中会提示选择运行时Claude Code 等和安装范围全局或项目级。6. 实战示例用 GSD 开发一个 CLI 待办事项工具假设你要开发一个命令行待办事项管理工具技术栈选 Node.js TypeScript。以下是完整操作步骤。每个 Step 都标注了操作位置和自动/手动的说明。Step 1初始化项目在 Claude Code 聊天框输入斜杠命令/gsd-new-projectGSD 会在对话框里逐条提问你逐条回答GSD → ? What is your project name? 你 → todo-cli GSD → ? What tech stack? 你 → Node.js TypeScript GSD → ? Brief description? 你 → A CLI todo management tool with add/done/list/delete回答完毕后GSD自动在项目目录下生成PROJECT.md— 项目总览名称、技术栈、简介REQUIREMENTS.md— 需求规格功能列表、技术选型详情ROADMAP.md— 路线图分 3 个 Phase每个 Phase 的目标✅ Step 1 完成。接下来进入下一步。Step 2规划第一个阶段在 Claude Code 聊天框输入注意后面带参数1表示规划 Phase 1/gsd-plan-phase 1GSD自动读取REQUIREMENTS.md中 Phase 1 的范围输出规划GSD → 分析 Phase 1 范围 - Task CRUD增删改查 - JSON 文件持久化 - 命令行交互界面 GSD → 生成实现计划 → PLANS/phase-1.md产出的PLANS/phase-1.md包含目录结构设计数据模型Todo 接口、存储层接口CLI 命令设计add / done / list / delete 四个子命令每个任务的预估工作量和依赖关系✋你需要手动review 这个计划确认无误后再进入下一步。✅ Step 2 完成。接下来进入下一步。Step 3执行 Phase 1在 Claude Code 聊天框输入参数1表示执行 Phase 1/gsd-execute-phase 1GSD自动将 Phase 1 拆成 3 个子任务每个子任务开一个全新的上下文窗口并行执行子任务内容是否可并行Task A定义 Todo 接口和存储层ITodoStore是Task B实现 CLI 命令解析add/done/list/delete是依赖 A 的接口Task C实现 JSON 文件持久化JsonTodoStore是执行过程中你在主窗口看到的进度GSD → Spawning sub-agents... Task A (data-model) → 新窗口 → 进行中 Task B (cli-parser) → 新窗口 → 等待 Task A Task C (json-store) → 新窗口 → 进行中 ... 3/3 tasks completed执行完成后GSD自动汇总结果到STATE.md更新进度状态。你不需要手动合并子代理的代码。✅ Step 3 完成。代码已经写好了接着验证。Step 4验证成果在 Claude Code 聊天框输入参数1表示验证 Phase 1/gsd-verify-work 1GSD自动启动验证代理GSD → Running tests... PASS Linting codebase... PASS Type checking... PASS Checking for edge cases...发现 1 个问题 → 问题delete 命令传入不存在的 ID 时未做错误处理 → 启动调试代理修复... DONE验证代理发现 bug 会自动修复修复完再跑一遍确保通过。你不需要手动修。✅ Step 4 完成。验证通过后准备交付。Step 5交付在 Claude Code 聊天框输入/gsd-shipGSD自动执行交付流程GSD → Creating git commit... DONE Tagging v0.1.0... DONE Generating release notes... DONE PR created → 合并到主分支 至此Phase 1基础 CRUD开发完成已合并到主分支并打标签。整个过程你只输入了 5 条命令中间不需要手动操作。第二天继续开发关掉会话后第二天回来在 Claude Code 聊天框输入/gsd-resumeGSD自动从STATE.md读取进度GSD → 恢复 Phase 1 已完成状态 上次进度Phase 1 done下一步可规划 Phase 2然后你接着输入/gsd-plan-phase 2开始下一阶段即可。所有状态都在文件里不怕关窗口。关键点整个过程中主窗口始终保持低水位30-40% token 使用率不会被实现细节填满。每个子代理干活时都是满血 200K token。今天关掉明天/gsd-resume继续质量不降。7. 优点 缺点✅ 优点❌ 缺点解决上下文腐烂长会话不降质只提供 1 种安装方式子代理独立上下文并行执行小任务用 GSD 太重文件持久化不怕会话丢失需要学习工作流命令跨 15 运行时规划目录多了会乱