GSD 2 Agent Framework Skill：让 AI 自主完成整个项目开发周期的元框架

GSD 2 Agent Framework Skill：让 AI 自主完成整个项目开发周期的元框架

功能与原则

GSD 2 是一个独立的 CLI 工具，核心思路是把一份结构化规格说明书（Spec）转化为完全自主运行的软件。它直接控制 AI Agent 的运行载体——管理每个任务全新的上下文窗口、git worktree 隔离、崩溃恢复、成本追踪和卡死检测——而不是依赖 LLM 自我循环。开发者只需一条命令，然后离开，回来时项目已经完成，git 历史干净整洁。

设计原则：任务必须fits一个上下文窗口（Context Window），如果太大就拆成两个任务。

认可度

• GitHub Star：约 7,760（截至 2026-08-13，数据来源 gsd-build/gsd-2 仓库）
• 来自 aradotso/trending-skills 的自动技能收录，该仓库目前 71 stars，是 GitHub Trending 上的 Claude Code Skills 聚合项目
• 作者 ara.so 每日从 GitHub Trending 自动抓取新晋 Skill，质量经过社区过滤

链接

GitHub：https://github.com/gsd-build/gsd-2

原作者

• ara.so — 独立开发者，维护 aradotso/trending-skills（GitHub Trending Claude Code Skills 聚合），每日自动从 GitHub 趋势项目生成可用 Skill
• gsd-2 核心框架由 gsd-build 组织维护

介绍

GSD 2 的灵感来自 Y Combinator 总裁 Garry Tan 的工作流方法论。他曾说「我大概从去年12月起就没手动打过一行代码了」，在 AI 辅助下 2026 年的逻辑代码产出速度是 2013 年的约 810 倍。GSD 2 将这套方法论产品化为一个可复用的自主开发框架。

传统的 AI 编程 Agent 往往在长任务中「迷路」——上下文窗口耗尽、代码膨胀、难以从错误中恢复。GSD 2 的解法是把项目拆成严格的层级结构：Milestone（可发布版本）→ Slice（可演示的垂直能力）→ Task（一个上下文窗口大小的工作单元）。每个 Task 都是自洽的，Agent 在fresh context下运行，失败只影响当前 Task，不污染全局状态。

安装只需一条命令：npm install -g gsd-pi，需要 Node.js 18+，底层调用 Anthropic Claude（通过 Pi SDK）。

特点

• Spec-Driven：一切从 PROJECT.md 和 ROADMAP.md 开始，Agent 按规格执行而非自由发挥
• Worktree 隔离：每个 Task 在独立 git worktree 中运行，不会污染主分支历史
• 崩溃恢复：LOCK 文件机制 + 卡死检测，宕机后可以从中断处继续而非从头来过
• 成本追踪：内置 costs/ledger.json 记录每个工作单元的 token 消耗，预算可控
• Milestone/Slice/Task 三级层次：强制拆分复杂度，避免 Agent 在长任务中上下文爆炸
• 零配置上手：/gsd auto 一条命令启动全自动开发模式，开发者可以真的「离开去喝咖啡」

使用方法

安装：

npm install -g gsd-pi

初始化项目：

# 在空目录或已有代码库中
gsd init
# 生成 .gsd/STATE.md, ROADMAP.md, PROJECT.md 等结构

全自动模式：

gsd auto
# Agent 开始按 ROADMAP.md 中的 Milestone/Slice/Task 层级自主执行
# 每个 Task 完成后自动推进 STATE.md，崩溃后自动恢复

手动单步执行：

gsd plan    # 生成当前 Slice 的任务分解
gsd execute # 执行单个 Task
gsd review  # 检查完成质量

目录结构：

project/
├── .gsd/
│   ├── STATE.md      # 当前自动模式位置
│   ├── DECISIONS.md  # 架构决策登记
│   ├── LOCK          # 崩溃恢复锁
│   └── milestones/M1/slices/S1/tasks/T1/...
├── ROADMAP.md        # Milestone/Slice 结构
└── PROJECT.md        # 项目目标描述

使用场景与人群

适用场景：
– 从零开始的新项目开发（Web App、API 服务、CLI 工具等）
– 需要多日完成的复杂功能迭代
– 团队希望用 AI Agent 承接部分开发工作流，但需要质量护栏

目标用户：
– 个人开发者 / 独立 maker，想用 AI 承接更多开发工作
– 小型创业团队，用 AI 扩展工程能力
– AI 工程化研究者，测试自主 Agent 的长任务稳定性

输入与输出案例

输入（PROJECT.md 示例）：

# 项目：个人博客系统

## 目标
用 Next.js + MDX 构建一个高性能技术博客，支持暗色模式、标签分类、全文搜索。

## 约束
- 部署到 Vercel
- 首次加载 < 1.5s（Lighthouse）
- 不用 CMS，后台用文件系统

输出（/gsd auto 运行后）：
– .gsd/milestones/M1/ 下生成 Slice 和 Task 结构
– 每个 Task 执行后在 tasks/T1/SUMMARY.md 记录完成内容
– 最终产出：可部署的 Next.js 博客，代码在主分支，.gsd/ 目录保留决策和状态记录
– 全程无需人工介入，开发者可关闭电脑，次日回来看结果

GSD 2 代表了一种正在兴起的新范式——把 AI 编程从「辅助工具」升级为「自主承包商」。它不只是给 Agent 一个 Prompt，而是给了它一套工程治理结构：如何拆解任务、如何记录决策、如何从失败中恢复。对于想让 AI 真正承担完整开发工作的团队和个人，这是一个值得密切关注的项目。

GitHub: https://github.com/gsd-build/gsd-2