GSD Core

Git. Ship. Done.

English · Português · 简体中文 · 日本語 · 한국어

一套轻量级的元提示、上下文工程与规范驱动开发系统，适用于 Claude Code、OpenCode、Gemini CLI、Kilo、Codex、Copilot、Cursor、Windsurf 等 AI 编程工具。

什么是 GSD Core

GSD Core 是一套上下文工程与规范驱动开发框架，能够引导 AI 编程智能体（Claude Code、Codex、Gemini CLI、Copilot、Cursor 等）按照严格的阶段循环推进工作。它解决了上下文腐化问题——即随着 AI 填满上下文窗口而逐渐累积的质量下降——通过在全新上下文的子智能体中运行所有繁重的研究、规划和执行工作，同时保持主会话的精简。

工作原理

每个里程碑重复相同的五步循环，每次推进一个阶段：

1. 讨论（Discuss） — 在规划任何内容之前，先捕获实现决策
2. 规划（Plan） — 研究、分解，并验证计划能够适配全新的上下文窗口
3. 执行（Execute） — 以并行波次运行计划；每个执行器以干净的 20 万 token 上下文启动
4. 验证（Verify） — 检查已构建的内容；在宣告完成前诊断并修复问题
5. 交付（Ship） — 创建 PR，归档阶段，对下一个阶段重复上述流程

快速开始

npx @opengsd/gsd-core@latest

安装程序会提示选择运行时（Claude Code、OpenCode、Gemini CLI、Kilo、Codex、Copilot、Cursor、Windsurf 等）以及是全局安装还是本地安装。跨运行时兼容性需要使用安装程序——请勿直接从 agents/ 或 commands/ 目录复制文件。

使用其他运行时或没有 Node.js？请参阅在你的运行时上安装。

安装完成后，启动你的第一个项目：

/gsd-new-project

初次使用？请按照你的第一个项目进行引导式操作，从安装到完成第一个交付阶段。

文档

教程 — 边做边学：

• 你的第一个项目
• 接入现有代码库

操作指南 — 面向任务的实用方法：

• 在你的运行时上安装
• 规划一个阶段
• 验证与交付
• … 查看所有操作指南

参考文档 — 权威信息：

• 命令
• 配置
• CLI 工具

概念说明 — 设计理念与决策：

• 上下文工程
• 阶段循环
• 架构

完整索引：docs/zh-CN/README.md。其他语言：日本語 · 한국어 · Português · English。

为什么有效

大多数 AI 编程方案在规模化时都会失败，原因在于上下文膨胀会悄无声息地降低输出质量，各会话之间没有共享记忆，也没有任何机制来验证代码是否真正可用。GSD Core 解决了这三个问题：繁重的工作在全新的子智能体中运行，STATE.md 和 CONTEXT.md 等结构化工件能够跨越会话边界保持存续，验证步骤会检查已构建的内容并在宣告阶段完成前生成修复计划。完整的设计思路请参阅 docs/zh-CN/explanation/context-engineering.md。

遇到问题？请参阅 docs/zh-CN/how-to/recover-and-troubleshoot.md。

社区

| 项目 | 平台 | |---------|----------| | gsd-opencode | 原始 OpenCode 移植版 | | Discord | 社区支持 |

Star History

许可证

MIT 许可证。详情请参阅 LICENSE。

Claude Code 功能强大。GSD Core 让它更可靠。