open-gsd/gsd-core · 上手攻略
- 仓库：open-gsd/gsd-core
- 链接：https://github.com/open-gsd/gsd-core
- 分类：trending / engineering（Dev Tools）
- 作者：Jay
- 更新：2026-07-13
是什么
GSD Core（Git. Ship. Done）是一套轻量级元提示、上下文工程与规范驱动开发框架，专门解决 AI 编程工具（Claude Code、OpenCode、Gemini CLI、Copilot、Cursor、Windsurf 等）在规模化使用时的三大痛点：
- 上下文膨胀（Context Rot） — AI 填满上下文窗口后输出质量悄悄下降。
- 跨会话无记忆 — 每个新会话都从零开始，无法复用历史决策。
- 无验证机制 — 代码写完就跑，没人检查是否真的能用。
GSD Core 通过一个严格的五步阶段循环（Discuss → Plan → Execute → Verify → Ship）来组织工作，每个阶段都在子智能体的新鲜上下文中运行，保证每次决策都有充足 token 可用。
一句话总结：让 AI 编程工具从「随机发挥」变成「规范交付」的系统工程框架。
Stars：6442 ⭐ | 周增：+210 | 语言：JavaScript | 许可：MIT
解决什么问题
大多数 AI Coding 方案失败的原因是：
| 痛点 | 后果 |
|---|---|
| 上下文窗口被填满后质量下降 | AI 开始胡说、遗漏需求、重复造轮 |
| 多会话之间没有共享记忆 | 每次都要重新解释背景知识 |
| 没有验证环节 | PR 里的代码可能是半成品 |
| 主会话被长流程拖垮 | token 爆炸，响应变慢 |
GSD Core 的解法是把工作分配给专门的子智能体，主会话只做协调和审核，状态文档（STATE.md、CONTEXT.md）负责跨会话传递上下文。
快速安装
环境要求
- Node.js 18+（npx 运行）或任意支持的 AI 运行时（Claude Code、OpenCode 等）
- 推荐 Claude Code（原生支持最好）
通过 npx 安装（推荐）
npx @opengsd/gsd-core@latest
安装程序会提示： - 选择运行时（Claude Code / OpenCode / Gemini CLI / Kilo / Codex / Copilot / Cursor / Windsurf 等） - 选择全局安装还是本地安装
⚠️ 不要直接从
agents/或commands/目录手动复制文件——安装程序负责跨运行时兼容，手动复制会导致功能缺失。
没有 Node.js？或在其他运行时？
参见官方文档：Install on your runtime
核心用法
新建项目（Greenfield）
/gsd-new-project
按引导创建新项目，自动初始化 GSD 阶段结构。
接入现有代码库（Brownfield）
/gsd-onboard
对已有仓库进行 GSD 规范化改造，建立阶段循环结构。
五步阶段循环详解
每个里程碑（Milestone）重复以下五步：
① Discuss（讨论）
在规划之前，先捕获实现决策：用什么架构？有无技术约束？关键依赖？记录到 STATE.md，避免边做边改。
② Plan（规划） 在新鲜上下文的子智能体中研究、分解任务，验证方案能放进 20 万 token 的干净上下文。
③ Execute（执行） 以并行波次运行计划，每个执行器从干净上下文启动，互不干扰主会话。
④ Verify（验证） 遍历已构建内容，检查功能是否符合预期，生成修复计划后才宣告完成。
⑤ Ship（交付） 创建 PR，归档本阶段，对下一个里程碑重复。
关键文档
| 文件 | 作用 |
|---|---|
STATE.md |
当前里程碑的状态快照 |
CONTEXT.md |
跨会话传递的上下文摘要 |
*.phase.md |
各阶段的归档记录 |
典型适用场景
| 场景 | 为什么用 GSD |
|---|---|
| 大型重构项目 | 多轮迭代容易上下文爆炸，阶段循环保证每次决策都在干净上下文中 |
| 多人协作的 AI Coding | STATE.md 作为共享文档，解决"AI 不知道别人做了什么" |
| 需要交付可维护代码的团队 | Verify 环节强制检查，不允许半成品进 PR |
| 长期维护的 AI Agent 项目 | 跨会话记忆机制让新会话快速上手 |
坑与注意
- 安装程序是必须的：不要跳过安装程序直接复制文件，跨运行时兼容逻辑全在安装脚本里。
- 不是银弹：GSD Core 是组织框架，不负责修复 AI 本身的能力不足——模型弱的依然弱。
- 需要团队认同：如果只有你一个人用，Verify/Ship 环节会显得多余，团队共识很重要。
- 对小型项目可能过度工程：个人小脚本直接写就行了，不必套用五步循环。
- 国内 Node.js 环境注意：npm 源可能慢，建议提前配置淘宝镜像：
bash npm config set registry https://registry.npmmirror.com
与同类对比
| 项目 | 定位 | GSD Core 优势 |
|---|---|---|
| Claude Code 原生 | 单会话 AI 编程 | GSD 提供跨会话记忆与验证机制 |
| Aider | 终端 AI 编程工具 | GSD 更偏组织层，Aider 更偏执行层 |
| Devin (Cognition) | 全自动 AI 软件工程师 | GSD 是人的工具，保留人类决策权 |
| Cursor Rules / Windsurf Rules | 项目级上下文规则 | GSD 是动态的会话循环，Rules 是静态配置 |
| open-gsd/gsd-opencode | OpenCode 的 GSD 移植 | open-gsd 是上游核心库，gsd-opencode 是运行时适配 |
一句话推荐结论
如果你经常遇到"AI 写到一半开始胡说""上下文窗口满了质量崩了""代码写完没人检查就上线"——GSD Core 是目前最轻量、最实用的结构性解法，值得一试。