GSD2 - 技术发现报告

GSD2 是一个基于 Pi SDK 的独立 CLI 应用（TypeScript），通过规格驱动开发（Spec-Driven Development）、里程碑-切片-任务三级分解、每个任务独立 200K token 上下文窗口和自动模式状态机，实现 AI 编码代理长时间自主工作而不丢失全局视图的元提示和上下文工程系统。

GSD2 - 技术发现报告

基本信息

  • 名称： GSD2（Get Shit Done 2，npm 包名 gsd-pi）
  • 官方地址： https://github.com/gsd-build/gsd-2（GitHub 仓库，无独立官网）
  • GitHub 仓库： https://github.com/gsd-build/gsd-2
  • 当前版本： v2.71（npm 包 gsd-pi@latest）
  • License： MIT
  • 主要编程语言： TypeScript
  • 首次发布日期： 2026-03-11（GitHub 仓库创建日期）
  • 创建者/维护团队： Lex Christopherson（glittercowboy）/ gsd-build 组织

一句话定位

GSD2 是一个基于 Pi SDK 的独立 CLI 应用（TypeScript），通过规格驱动开发（Spec-Driven Development）、里程碑-切片-任务三级分解、每个任务独立 200K token 上下文窗口和自动模式状态机，实现 AI 编码代理长时间自主工作而不丢失全局视图的元提示和上下文工程系统。

核心特性

  1. 规格驱动三级分解（Spec-Driven Milestone → Slice → Task Hierarchy） - 将大型项目分解为里程碑（Milestone）、切片（Slice）和任务（Task）三级结构，每个任务的设计保证适配单个上下文窗口。系统自动维护规格文档，代理在每个任务开始时获得完整的全局视图和精确的任务指令。

  2. 双模式执行（Step Mode + Auto Mode State Machine） - Step 模式逐单元执行，适合需要人工审查的场景；Auto 模式通过完整的状态机（planning → ready → executing → verifying → merging → replanning）实现全自动自主工作，包含卡住检测、超时监督和自适应重新规划。

  3. 每个任务独立 200K 上下文窗口（Fresh Context per Task） - 每个任务启动时创建全新的 200K token 上下文，避免前序任务的上下文污染。同时通过精心设计的规格注入机制确保代理获得完整的全局视图，实现"独立上下文 + 全局理解"的平衡。

  4. 24 个内置扩展 + 5 个专业子代理（Bundled Extensions & Specialized Subagents） - 内置 Browser Tools、Search、GitHub、MCP Client 等 24 个扩展，以及 Scout（侦察）、Researcher（研究）、Worker（执行）、JavaScript Pro、TypeScript Pro 五个专业子代理，覆盖从信息收集到代码实现的完整工作流。

  5. Crash Recovery + 自适应重新规划（Crash Recovery & Adaptive Replanning） - 系统在崩溃或中断后能从上一个检查点恢复继续执行。内置卡住检测机制，当代理在某个任务上停滞时自动触发重新规划。验证强制执行确保每个任务完成前必须通过验证步骤。

  6. 每阶段模型选择 + 20+ 模型提供商（Per-Phase Model Selection） - 支持为规划、执行、验证等不同阶段选择不同的 AI 模型。支持 OpenAI、Anthropic、Google、xAI、Mistral、DeepSeek 等 20+ 模型提供商，配合 token 优化配置（budget/balanced/quality）平衡成本和质量。

社区生态

  • GitHub Stars： 5,505（截至 2026-04-13，GitHub API 实时查询）
  • Forks： 577
  • Open Issues： 416
  • Contributors： gsd-build 组织（以 Lex Christopherson 为核心）
  • 最近更新日期： 2026-04-12（GitHub 最后推送日期，项目高度活跃）
  • 社区讨论热度： 高。GSD 组织下多个仓库总 Stars 超 31,000，活跃 Discord 社区，dev.to 和 Medium 有多篇深度评测文章，YouTube 有视频评测，Reddit 和 Hacker News 有讨论帖。
  • NPM 包： gsd-pi（可通过 npm install -g gsd-pi@latest 安装）

技术栈定位

  • 所属领域： AI 编码代理 / 规格驱动开发（Spec-Driven Development）/ 上下文工程（Context Engineering）/ 元提示系统（Meta-Prompting）/ 自主编码（Autonomous Coding）
  • 解决的核心问题： 传统 AI 编码工具（如 Cursor、Claude Code）在长时间、多文件、复杂项目上容易丢失上下文、遗忘全局目标、产生不一致的代码。GSD2 通过三级分解 + 每任务独立上下文 + 自动模式状态机，让 AI 代理能长时间自主工作而不丢失全局视图。v1 是纯 Markdown 提示模板，v2 演进为完整的 TypeScript 应用，拥有精细的上下文控制能力。
  • 替代/竞品技术： BMAD（企业级 SDLC，21+ 代理）、Superpowers（Skills + 守卫栏）、SpecKit（静态 Markdown 规格）、Ralph Loop（自迭代自主代理）、Claude Code（基础编码代理）、Cursor（IDE 集成编码）
  • 依赖的上游技术： Pi SDK（运行时框架）、Node.js / npm（运行环境）、Git / Git Worktree（版本控制和隔离）、20+ AI 模型提供商 API
  • 下游使用者/集成方： 独立开发者、软件开发团队（Amazon、Google、Shopify、Webflow 等公司有使用报告）、CI/CD 流水线（通过 headless 模式）

关键链接汇总

官方资源

教程资源

社区资源

信息来源