3bb2f8f1c5
* chore: wire docs/agents config into AGENTS.md Agent skills section
Add the `## Agent skills` discovery block pointing the engineering
skills at the existing docs/agents/{issue-tracker,triage-labels,domain}.md
files (issue tracker, triage label mapping, single-context domain docs).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
* docs: rebrand to GSD Core and restructure docs with Diataxis
Reorganise the root README and docs/ around the Diataxis framework
(tutorials, how-to guides, reference, explanation), add new how-to
guides and schema references (STATE.md / CONTEXT.md / PLAN.md /
planning artifacts), and cross-link the whole set. Update the lone
legacy gsd-build reference to open-gsd; keep internal get-shit-done/
filesystem paths unchanged (directory rename tracked separately in
open-gsd/gsd-core#604). Regenerate the ja-JP, ko-KR, pt-BR and zh-CN
localised trees to mirror the new structure.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
* docs: backfill changeset PR number (#605)
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
126 lines
5.7 KiB
Markdown
126 lines
5.7 KiB
Markdown
<div align="center">
|
||
|
||
# GSD Core
|
||
|
||
**Git. Ship. Done.**
|
||
|
||
[English](README.md) · [Português](README.pt-BR.md) · **简体中文** · [日本語](README.ja-JP.md) · [한국어](README.ko-KR.md)
|
||
|
||
**一套轻量级的元提示、上下文工程与规范驱动开发系统，适用于 Claude Code、OpenCode、Gemini CLI、Kilo、Codex、Copilot、Cursor、Windsurf 等 AI 编程工具。**
|
||
|
||
[](https://www.npmjs.com/package/@opengsd/gsd-core)
|
||
[](https://www.npmjs.com/package/@opengsd/gsd-core)
|
||
[](https://github.com/open-gsd/gsd-core/actions/workflows/test.yml)
|
||
[](https://discord.gg/mYgfVNfA2r)
|
||
[](https://github.com/open-gsd/gsd-core)
|
||
[](LICENSE)
|
||
|
||
</div>
|
||
|
||
---
|
||
|
||
## 什么是 GSD Core
|
||
|
||
GSD Core 是一套上下文工程与规范驱动开发框架，能够引导 AI 编程智能体（Claude Code、Codex、Gemini CLI、Copilot、Cursor 等）按照严格的阶段循环推进工作。它解决了[上下文腐化](docs/zh-CN/explanation/context-engineering.md)问题——即随着 AI 填满上下文窗口而逐渐累积的质量下降——通过在全新上下文的子智能体中运行所有繁重的研究、规划和执行工作，同时保持主会话的精简。
|
||
|
||
---
|
||
|
||
## 工作原理
|
||
|
||
每个里程碑重复相同的五步循环，每次推进一个阶段：
|
||
|
||
1. **讨论（Discuss）** — 在规划任何内容之前，先捕获实现决策
|
||
2. **规划（Plan）** — 研究、分解，并验证计划能够适配全新的上下文窗口
|
||
3. **执行（Execute）** — 以并行波次运行计划；每个执行器以干净的 20 万 token 上下文启动
|
||
4. **验证（Verify）** — 检查已构建的内容；在宣告完成前诊断并修复问题
|
||
5. **交付（Ship）** — 创建 PR，归档阶段，对下一个阶段重复上述流程
|
||
|
||
---
|
||
|
||
## 快速开始
|
||
|
||
```bash
|
||
npx @opengsd/gsd-core@latest
|
||
```
|
||
|
||
安装程序会提示选择运行时（Claude Code、OpenCode、Gemini CLI、Kilo、Codex、Copilot、Cursor、Windsurf 等）以及是全局安装还是本地安装。跨运行时兼容性需要使用安装程序——请勿直接从 `agents/` 或 `commands/` 目录复制文件。
|
||
|
||
使用其他运行时或没有 Node.js？请参阅[在你的运行时上安装](docs/zh-CN/how-to/install-on-your-runtime.md)。
|
||
|
||
安装完成后，启动你的第一个项目：
|
||
|
||
```bash
|
||
/gsd-new-project
|
||
```
|
||
|
||
初次使用？请按照[你的第一个项目](docs/zh-CN/tutorials/your-first-project.md)进行引导式操作，从安装到完成第一个交付阶段。
|
||
|
||
---
|
||
|
||
## 文档
|
||
|
||
**教程** — 边做边学：
|
||
- [你的第一个项目](docs/zh-CN/tutorials/your-first-project.md)
|
||
- [接入现有代码库](docs/zh-CN/tutorials/onboarding-an-existing-codebase.md)
|
||
|
||
**操作指南** — 面向任务的实用方法：
|
||
- [在你的运行时上安装](docs/zh-CN/how-to/install-on-your-runtime.md)
|
||
- [规划一个阶段](docs/zh-CN/how-to/plan-a-phase.md)
|
||
- [验证与交付](docs/zh-CN/how-to/verify-and-ship.md)
|
||
- … [查看所有操作指南](docs/zh-CN/README.md#how-to-guides)
|
||
|
||
**参考文档** — 权威信息：
|
||
- [命令](docs/zh-CN/COMMANDS.md)
|
||
- [配置](docs/zh-CN/CONFIGURATION.md)
|
||
- [CLI 工具](docs/zh-CN/CLI-TOOLS.md)
|
||
|
||
**概念说明** — 设计理念与决策：
|
||
- [上下文工程](docs/zh-CN/explanation/context-engineering.md)
|
||
- [阶段循环](docs/zh-CN/explanation/the-phase-loop.md)
|
||
- [架构](docs/zh-CN/ARCHITECTURE.md)
|
||
|
||
完整索引：[docs/zh-CN/README.md](docs/zh-CN/README.md)。其他语言：[日本語](README.ja-JP.md) · [한국어](README.ko-KR.md) · [Português](README.pt-BR.md) · [English](README.md)。
|
||
|
||
---
|
||
|
||
## 为什么有效
|
||
|
||
大多数 AI 编程方案在规模化时都会失败，原因在于上下文膨胀会悄无声息地降低输出质量，各会话之间没有共享记忆，也没有任何机制来验证代码是否真正可用。GSD Core 解决了这三个问题：繁重的工作在全新的子智能体中运行，`STATE.md` 和 `CONTEXT.md` 等结构化工件能够跨越会话边界保持存续，验证步骤会检查已构建的内容并在宣告阶段完成前生成修复计划。完整的设计思路请参阅 [docs/zh-CN/explanation/context-engineering.md](docs/zh-CN/explanation/context-engineering.md)。
|
||
|
||
遇到问题？请参阅 [docs/zh-CN/how-to/recover-and-troubleshoot.md](docs/zh-CN/how-to/recover-and-troubleshoot.md)。
|
||
|
||
---
|
||
|
||
## 社区
|
||
|
||
| 项目 | 平台 |
|
||
|---------|----------|
|
||
| [gsd-opencode](https://github.com/rokicool/gsd-opencode) | 原始 OpenCode 移植版 |
|
||
| [Discord](https://discord.gg/mYgfVNfA2r) | 社区支持 |
|
||
|
||
---
|
||
|
||
## Star History
|
||
|
||
<a href="https://star-history.com/#open-gsd/gsd-core&Date">
|
||
<picture>
|
||
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=open-gsd/gsd-core&type=Date&theme=dark" />
|
||
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=open-gsd/gsd-core&type=Date" />
|
||
<img alt="Star History Chart" src="https://api.star-history.com/svg?repos=open-gsd/gsd-core&type=Date" />
|
||
</picture>
|
||
</a>
|
||
|
||
---
|
||
|
||
## 许可证
|
||
|
||
MIT 许可证。详情请参阅 [LICENSE](LICENSE)。
|
||
|
||
---
|
||
|
||
<div align="center">
|
||
|
||
**Claude Code 功能强大。GSD Core 让它更可靠。**
|
||
|
||
</div>
|