GSD 新手入门指南用 Claude Code 实现计划驱动的单智能体开发【免费下载链接】get-shit-doneA light-weight and powerful meta-prompting, context engineering and spec-driven development system for Claude Code by TÂCHES.项目地址: https://gitcode.com/GitHub_Trending/getshi/get-shit-doneGSDGet Shit Done是面向 Claude Code 单智能体开发场景的计划驱动式开发系统它把一句模糊的想法逐步转化为层级化计划再按阶段phase逐个执行全程以状态文件跟踪进度、以原子提交固化每个改动。这篇指南基于仓库中的新手导览文档 get-shit-done/workflows/help/modes/default.md 展开读完你可以掌握 GSD 的三条启动命令、常用命令速查、分级帮助体系与更新机制并理解其 help 模式在仓库中是如何实现的。GSD 是什么面向 solo agentic 工作的计划驱动开发GSD 的核心定位一句话即可概括为 Claude Code 上的单人智能体工作提供 plan-driven development。它把一个模糊想法变成一份层级化计划然后分阶段执行过程中依靠状态跟踪与原子提交保证每一步都可回溯。在仓库中这段描述以purpose字段的形式写在帮助文档的头部见 get-shit-done/workflows/help/modes/default.md而完整命令参考则沉淀在同目录的 get-shit-done/workflows/help/modes/full.md 中。作为新手你不必一次读完所有命令——GSD 设计了四层帮助体系从 10 行速查到完整参考按需取用本文后面会专门展开。三步上手从 0 到第一次执行default.md给出的启动路径只有三条命令构成 GSD 最小可用闭环/gsd:new-project # Greenfield: questioning → research → requirements → roadmap /gsd:plan-phase 1 # Create a detailed plan for phase 1 /gsd:execute-phase 1 # Execute all plans in the phase/gsd:new-project统一的项目初始化流程。它依次完成深度提问理解你要构建什么、可选的领域研究并行派发 4 个研究型子智能体分别调研 Stack / Features / Architecture / Pitfalls、带 v1/v2/Out-of-Scope 边界划分的需求定义以及带阶段拆解与成功标准的路线图生成。整个流程结束后会在.planning/目录下落地PROJECT.md愿景与需求、config.json工作流模式、research/领域研究、REQUIREMENTS.md带 REQ-ID 的需求、ROADMAP.md映射到需求的阶段与STATE.md项目记忆。更完整的流程细节见 get-shit-done/workflows/new-project.md。/gsd:plan-phase 1为阶段 1 生成可执行的PLAN.md。它会将阶段拆解为具体、可操作的任务并附带验证标准与成功度量产物路径形如.planning/phases/XX-phase-name/XX-YY-PLAN.md一个阶段支持多份计划XX-01、XX-02……。/gsd:execute-phase 1执行该阶段内的全部计划。它按计划 frontmatter 中的 wave 分组、按波次串行推进同一波次内的计划可并行阶段目标全部完成后会更新REQUIREMENTS.md、ROADMAP.md、STATE.md。底层实现含 wave 分组、worktree 隔离与 post-merge 构建测试门禁见 get-shit-done/workflows/execute-phase.md。已有代码库怎么办先 map-codebasedefault.md特别提醒如果是既有代码库先运行/gsd:map-codebase让 GSD 先扎根在你的真实代码之上再进行项目初始化。该命令会用并行的 Explore 智能体分析代码库在.planning/codebase/下生成 7 份聚焦文档栈、架构、结构、约定、测试、集成、风险支持--fast轻量评估、--focus area限定范围与--query term检索.planning/intel/中的代码情报索引。常用命令速查表完整继承default.md用一张表给出了新手最常用的 9 个命令下面逐条展开补充其在完整参考 get-shit-done/workflows/help/modes/full.md 中的关键行为命令用途关键行为与标志/gsd:progress我在哪、下一步做什么显示可视化进度条与完成百分比--next自动推进到下一步--forensic追加 6 项完整性审计--do ...充当智能路由器把自由文本意图自动分派到最匹配的 GSD 命令/gsd:quick小规模临时任务但保留 GSD 保证只派生 planner executor默认跳过 researcher/checker/verifier产物位于.planning/quick/--full恢复完整质量流水线--validate/--discuss/--research可组合叠加/gsd:fast task微不足道的行内改动不派生任何子智能体、不生成 PLAN/SUMMARY 文件最多 3 个文件改动超出则重定向到/gsd:quick改完原子提交并记录到 STATE.md/gsd:discuss-phase N在规划前捕获愿景与决策支持--chain链式提问、--analyze深度假设分析、--power扩展问题集、--assumptions无交互暴露实现假设、--batch[N]2-5 个相关问题批量问/gsd:debug symptom持久化调试会话通过自适应提问收集症状在.planning/debug/下以证据→假设→验证的科学方法排查会话状态在/clear后依然存活无参数重跑即可续接--diagnose只做一次性诊断/gsd:capture保存想法 / 待办 / 笔记 / seed / backlog默认从对话上下文提取结构化 todo 存入.planning/todos/pending/--note零摩擦笔记--seed带触发条件的远期想法--backlog放入 999.x 编号的停车场--list [area]列出并开始处理/gsd:verify-work N对已完成阶段做对话式 UAT从 SUMMARY.md 提取可测试交付物逐个以 yes/no 呈现失败自动诊断并生成修复计划/gsd:ship N从已完成阶段发起 PR推送分支、以 SUMMARY/VERIFICATION/REQUIREMENTS 生成 PR 正文、可选请求代码评审前置条件阶段已验证、ghCLI 已安装并认证/gsd:help --full完整参考覆盖全部命令与标志即 get-shit-done/workflows/help/modes/full.md 全文再进一步GSD 的四层帮助体系default.md的Want more?一节展示了一个精心设计的分级帮助体系——同样的命令参考按需提供四种粒度/gsd:help --brief # 10-line refresher of top commands /gsd:help --full # complete reference /gsd:help topic # one section only — see topics below /gsd:help --brief topic # compact scoped lookup — signature one-line summary--brief约 10 行的顶部命令速查适合老用户快速唤起记忆对应 get-shit-done/workflows/help/modes/brief.md。无参数默认即本篇文章所依托的一页式新手导览get-shit-done/workflows/help/modes/default.md。--full完整命令参考包含全部命令、标志、.planning/目录结构、工作流模式与规划配置get-shit-done/workflows/help/modes/full.md。topic/--brief topic只输出匹配章节--brief topic进一步压缩为签名 一行摘要的紧凑查表。默认导览列出 14 个可查主题workflow·planning·execute·quick·debug·capture·ship·config·milestones·spike·sketch·review·audit·progress。每个主题输出前都会带一行已解析路由的前缀**Topic:** alias → heading *(scope: full | compact)*让你清楚看到自己命中了哪一节未知主题则会回显可识别的主题列表。help 路由机制在仓库中如何实现分级帮助不是硬编码在单文件里而是一套可维护的懒加载路由入口契约在 commands/gsd/help.md它声明了参数提示[--brief | --full | topic | --brief topic]并把自己的执行上下文指向工作流 get-shit-done/workflows/help.md。路由决策在 get-shit-done/workflows/help.md其中progressive_disclosure块声明了模式文件懒加载策略——根据$ARGUMENTS只读取一个匹配的模式文件然后原样输出其reference正文。规则包括--brief/-b单独出现读brief.md--full/-f/--all单独出现读full.md参数为空读default.md--brief topic走topic.md的紧凑作用域其余裸主题或--full topic走topic.md的完整作用域。多个标志同时出现时还定义了优先级如--brief与--full互斥时偏好--full。主题抽取在 get-shit-done/workflows/help/modes/topic.md内置一张主题别名 → 章节标题的解析表如init/new-project→### Project Initializationprogress/route→### Progress Tracking加### Smart Router并定义了 5a/5b/5c 三种抽取规则处理单节、多节拼接与子块三种情况紧凑作用域只取签名行与紧跟的一行摘要。这一设计的价值在于模式文件之间通过渐进式披露progressive disclosure互不冗余参考内容单点维护而调用侧无论怎么组合参数都能得到确定性的路由结果。更新 GSDGSD 迭代很快导览文档建议周期性更新直接运行npx get-shit-done-cclatest仓库内还提供了更完善的/gsd:update命令见完整参考它会对比已安装版本与最新版本、展示你错过的版本变更日志、高亮破坏性变更并在安装前确认比裸跑npx更安全--sync负责同步受管技能--reapply可在更新后重新应用本地修改。从导览到流水线三条命令背后的状态与产物最后把视角拉高default.md的三步上手本质上是 GSD 主流水线的最小切片。从完整参考与工作流源码可以确认每一步都在.planning/目录留下可审计的痕迹.planning/ ├── PROJECT.md # 项目愿景与需求Validated / Active / Out of Scope Key Decisions ├── ROADMAP.md # 当前阶段拆解与依赖 ├── STATE.md # 项目记忆与上下文会话续接的权威来源 ├── config.json # 工作流模式与门禁interactive / yolo ├── requirements/ # 带 REQ-ID 的需求v1/v2/out-of-scope 分级 ├── research/ # 领域研究new-project 阶段可选 ├── codebase/ # 代码库地图brownfield 项目 └── phases/ ├── 01-foundation/ │ ├── 01-01-PLAN.md │ └── 01-01-SUMMARY.md流水线的每一次推进都遵守规划文档 原子提交的纪律plan-phase生成 PLAN.mdexecute-phase让每个任务的改动独立提交、完成计划后回写 SUMMARY.md最终统一更新 REQUIREMENTS/ROADMAP/STATEworktree 并行模式下由编排者统一写入共享文件避免 last-merge-wins 覆盖。这也解释了导览中state tracking and atomic commits的承诺——它不是口号而是落在每个阶段产物与 git 历史中的硬约束。对新手而言记住这条主线就够用了new-project 建立计划骨架 → plan-phase 把阶段细化为可执行任务 → execute-phase 分批执行并回写状态期间任何时候迷路了/gsd:progress会告诉你我在哪、下一步做什么。更深的机制探索可以从 get-shit-done/workflows/new-project.md、get-shit-done/workflows/plan-phase.md 和 get-shit-done/workflows/execute-phase.md 三份工作流源码继续深入。【免费下载链接】get-shit-doneA light-weight and powerful meta-prompting, context engineering and spec-driven development system for Claude Code by TÂCHES.项目地址: https://gitcode.com/GitHub_Trending/getshi/get-shit-done创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 GSD 新手入门指南：用 Claude Code 实现计划驱动的单智能体开发
GSD 新手入门指南用 Claude Code 实现计划驱动的单智能体开发【免费下载链接】get-shit-doneA light-weight and powerful meta-prompting, context engineering and spec-driven development system for Claude Code by TÂCHES.项目地址: https://gitcode.com/GitHub_Trending/getshi/get-shit-doneGSDGet Shit Done是面向 Claude Code 单智能体开发场景的计划驱动式开发系统它把一句模糊的想法逐步转化为层级化计划再按阶段phase逐个执行全程以状态文件跟踪进度、以原子提交固化每个改动。这篇指南基于仓库中的新手导览文档 get-shit-done/workflows/help/modes/default.md 展开读完你可以掌握 GSD 的三条启动命令、常用命令速查、分级帮助体系与更新机制并理解其 help 模式在仓库中是如何实现的。GSD 是什么面向 solo agentic 工作的计划驱动开发GSD 的核心定位一句话即可概括为 Claude Code 上的单人智能体工作提供 plan-driven development。它把一个模糊想法变成一份层级化计划然后分阶段执行过程中依靠状态跟踪与原子提交保证每一步都可回溯。在仓库中这段描述以purpose字段的形式写在帮助文档的头部见 get-shit-done/workflows/help/modes/default.md而完整命令参考则沉淀在同目录的 get-shit-done/workflows/help/modes/full.md 中。作为新手你不必一次读完所有命令——GSD 设计了四层帮助体系从 10 行速查到完整参考按需取用本文后面会专门展开。三步上手从 0 到第一次执行default.md给出的启动路径只有三条命令构成 GSD 最小可用闭环/gsd:new-project # Greenfield: questioning → research → requirements → roadmap /gsd:plan-phase 1 # Create a detailed plan for phase 1 /gsd:execute-phase 1 # Execute all plans in the phase/gsd:new-project统一的项目初始化流程。它依次完成深度提问理解你要构建什么、可选的领域研究并行派发 4 个研究型子智能体分别调研 Stack / Features / Architecture / Pitfalls、带 v1/v2/Out-of-Scope 边界划分的需求定义以及带阶段拆解与成功标准的路线图生成。整个流程结束后会在.planning/目录下落地PROJECT.md愿景与需求、config.json工作流模式、research/领域研究、REQUIREMENTS.md带 REQ-ID 的需求、ROADMAP.md映射到需求的阶段与STATE.md项目记忆。更完整的流程细节见 get-shit-done/workflows/new-project.md。/gsd:plan-phase 1为阶段 1 生成可执行的PLAN.md。它会将阶段拆解为具体、可操作的任务并附带验证标准与成功度量产物路径形如.planning/phases/XX-phase-name/XX-YY-PLAN.md一个阶段支持多份计划XX-01、XX-02……。/gsd:execute-phase 1执行该阶段内的全部计划。它按计划 frontmatter 中的 wave 分组、按波次串行推进同一波次内的计划可并行阶段目标全部完成后会更新REQUIREMENTS.md、ROADMAP.md、STATE.md。底层实现含 wave 分组、worktree 隔离与 post-merge 构建测试门禁见 get-shit-done/workflows/execute-phase.md。已有代码库怎么办先 map-codebasedefault.md特别提醒如果是既有代码库先运行/gsd:map-codebase让 GSD 先扎根在你的真实代码之上再进行项目初始化。该命令会用并行的 Explore 智能体分析代码库在.planning/codebase/下生成 7 份聚焦文档栈、架构、结构、约定、测试、集成、风险支持--fast轻量评估、--focus area限定范围与--query term检索.planning/intel/中的代码情报索引。常用命令速查表完整继承default.md用一张表给出了新手最常用的 9 个命令下面逐条展开补充其在完整参考 get-shit-done/workflows/help/modes/full.md 中的关键行为命令用途关键行为与标志/gsd:progress我在哪、下一步做什么显示可视化进度条与完成百分比--next自动推进到下一步--forensic追加 6 项完整性审计--do ...充当智能路由器把自由文本意图自动分派到最匹配的 GSD 命令/gsd:quick小规模临时任务但保留 GSD 保证只派生 planner executor默认跳过 researcher/checker/verifier产物位于.planning/quick/--full恢复完整质量流水线--validate/--discuss/--research可组合叠加/gsd:fast task微不足道的行内改动不派生任何子智能体、不生成 PLAN/SUMMARY 文件最多 3 个文件改动超出则重定向到/gsd:quick改完原子提交并记录到 STATE.md/gsd:discuss-phase N在规划前捕获愿景与决策支持--chain链式提问、--analyze深度假设分析、--power扩展问题集、--assumptions无交互暴露实现假设、--batch[N]2-5 个相关问题批量问/gsd:debug symptom持久化调试会话通过自适应提问收集症状在.planning/debug/下以证据→假设→验证的科学方法排查会话状态在/clear后依然存活无参数重跑即可续接--diagnose只做一次性诊断/gsd:capture保存想法 / 待办 / 笔记 / seed / backlog默认从对话上下文提取结构化 todo 存入.planning/todos/pending/--note零摩擦笔记--seed带触发条件的远期想法--backlog放入 999.x 编号的停车场--list [area]列出并开始处理/gsd:verify-work N对已完成阶段做对话式 UAT从 SUMMARY.md 提取可测试交付物逐个以 yes/no 呈现失败自动诊断并生成修复计划/gsd:ship N从已完成阶段发起 PR推送分支、以 SUMMARY/VERIFICATION/REQUIREMENTS 生成 PR 正文、可选请求代码评审前置条件阶段已验证、ghCLI 已安装并认证/gsd:help --full完整参考覆盖全部命令与标志即 get-shit-done/workflows/help/modes/full.md 全文再进一步GSD 的四层帮助体系default.md的Want more?一节展示了一个精心设计的分级帮助体系——同样的命令参考按需提供四种粒度/gsd:help --brief # 10-line refresher of top commands /gsd:help --full # complete reference /gsd:help topic # one section only — see topics below /gsd:help --brief topic # compact scoped lookup — signature one-line summary--brief约 10 行的顶部命令速查适合老用户快速唤起记忆对应 get-shit-done/workflows/help/modes/brief.md。无参数默认即本篇文章所依托的一页式新手导览get-shit-done/workflows/help/modes/default.md。--full完整命令参考包含全部命令、标志、.planning/目录结构、工作流模式与规划配置get-shit-done/workflows/help/modes/full.md。topic/--brief topic只输出匹配章节--brief topic进一步压缩为签名 一行摘要的紧凑查表。默认导览列出 14 个可查主题workflow·planning·execute·quick·debug·capture·ship·config·milestones·spike·sketch·review·audit·progress。每个主题输出前都会带一行已解析路由的前缀**Topic:** alias → heading *(scope: full | compact)*让你清楚看到自己命中了哪一节未知主题则会回显可识别的主题列表。help 路由机制在仓库中如何实现分级帮助不是硬编码在单文件里而是一套可维护的懒加载路由入口契约在 commands/gsd/help.md它声明了参数提示[--brief | --full | topic | --brief topic]并把自己的执行上下文指向工作流 get-shit-done/workflows/help.md。路由决策在 get-shit-done/workflows/help.md其中progressive_disclosure块声明了模式文件懒加载策略——根据$ARGUMENTS只读取一个匹配的模式文件然后原样输出其reference正文。规则包括--brief/-b单独出现读brief.md--full/-f/--all单独出现读full.md参数为空读default.md--brief topic走topic.md的紧凑作用域其余裸主题或--full topic走topic.md的完整作用域。多个标志同时出现时还定义了优先级如--brief与--full互斥时偏好--full。主题抽取在 get-shit-done/workflows/help/modes/topic.md内置一张主题别名 → 章节标题的解析表如init/new-project→### Project Initializationprogress/route→### Progress Tracking加### Smart Router并定义了 5a/5b/5c 三种抽取规则处理单节、多节拼接与子块三种情况紧凑作用域只取签名行与紧跟的一行摘要。这一设计的价值在于模式文件之间通过渐进式披露progressive disclosure互不冗余参考内容单点维护而调用侧无论怎么组合参数都能得到确定性的路由结果。更新 GSDGSD 迭代很快导览文档建议周期性更新直接运行npx get-shit-done-cclatest仓库内还提供了更完善的/gsd:update命令见完整参考它会对比已安装版本与最新版本、展示你错过的版本变更日志、高亮破坏性变更并在安装前确认比裸跑npx更安全--sync负责同步受管技能--reapply可在更新后重新应用本地修改。从导览到流水线三条命令背后的状态与产物最后把视角拉高default.md的三步上手本质上是 GSD 主流水线的最小切片。从完整参考与工作流源码可以确认每一步都在.planning/目录留下可审计的痕迹.planning/ ├── PROJECT.md # 项目愿景与需求Validated / Active / Out of Scope Key Decisions ├── ROADMAP.md # 当前阶段拆解与依赖 ├── STATE.md # 项目记忆与上下文会话续接的权威来源 ├── config.json # 工作流模式与门禁interactive / yolo ├── requirements/ # 带 REQ-ID 的需求v1/v2/out-of-scope 分级 ├── research/ # 领域研究new-project 阶段可选 ├── codebase/ # 代码库地图brownfield 项目 └── phases/ ├── 01-foundation/ │ ├── 01-01-PLAN.md │ └── 01-01-SUMMARY.md流水线的每一次推进都遵守规划文档 原子提交的纪律plan-phase生成 PLAN.mdexecute-phase让每个任务的改动独立提交、完成计划后回写 SUMMARY.md最终统一更新 REQUIREMENTS/ROADMAP/STATEworktree 并行模式下由编排者统一写入共享文件避免 last-merge-wins 覆盖。这也解释了导览中state tracking and atomic commits的承诺——它不是口号而是落在每个阶段产物与 git 历史中的硬约束。对新手而言记住这条主线就够用了new-project 建立计划骨架 → plan-phase 把阶段细化为可执行任务 → execute-phase 分批执行并回写状态期间任何时候迷路了/gsd:progress会告诉你我在哪、下一步做什么。更深的机制探索可以从 get-shit-done/workflows/new-project.md、get-shit-done/workflows/plan-phase.md 和 get-shit-done/workflows/execute-phase.md 三份工作流源码继续深入。【免费下载链接】get-shit-doneA light-weight and powerful meta-prompting, context engineering and spec-driven development system for Claude Code by TÂCHES.项目地址: https://gitcode.com/GitHub_Trending/getshi/get-shit-done创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考