open-gsd/gsd-core

## 什么是 GSD Core GSD Core 是一个上下文工程与规范驱动开发框架，通过严格的阶段循环来驱动 AI 编程 agent（Claude Code、Codex、Gemini CLI、Kimi CLI、Copilot、Cursor 等）。它通过在全新上下文的 subagent 中运行所有繁重的研究、规划和执行工作，同时保持主会话的精简，从而解决了 [context rot](docs/explanation/context-engineering.md)（即 AI 在填满其上下文窗口时不断累积的质量下降问题）。 ## 工作原理 每个里程碑都会重复相同的五步循环，每次执行一个阶段： 1. **Discuss（讨论）** — 在进行任何规划之前，先确定实现决策 2. **Plan（规划）** — 研究、分解，并验证计划是否适合全新的上下文窗口 3. **Execute（执行）** — 以并行波次运行计划；每个执行器都从一个干净的 20 万 token 上下文开始 4. **Verify（验证）** — 审查已构建的内容；在宣布完成之前进行诊断和修复 5. **Ship（交付）** — 创建 PR，归档当前阶段，并重复下一个阶段 ## 快速开始 ``` npx @opengsd/gsd-core@latest ``` 安装程序会提示您选择运行时（Claude Code、OpenCode、Gemini CLI、Kimi CLI、Kilo、Codex、Copilot、Cursor、Windsurf 等）以及是全局安装还是本地安装。为了实现跨运行时兼容性，必须使用此安装程序——请勿直接从 `agents/` 或 `commands/` 复制文件。 使用其他运行时或没有 Node.js？请参阅[在您的运行时上安装](docs/how-to/install-on-your-runtime.md)。 安装完成后，开始您的第一个项目： ``` /gsd-new-project ``` 新手入门？请遵循[您的第一个项目](docs/tutorials/your-first-project.md)指南，它将引导您从安装到交付第一个阶段的完整流程。 ## 文档 **教程** — 在实践中学习： - [您的第一个项目](docs/tutorials/your-first-project.md) - [接入现有代码库](docs/tutorials/onboarding-an-existing-codebase.md) **操作指南** — 专注于特定任务的指南： - [在您的运行时上安装](docs/how-to/install-on-your-runtime.md) - [规划阶段](docs/how-to/plan-a-phase.md) - [验证并交付](docs/how-to/verify-and-ship.md) - … [查看所有操作指南](docs/README.md#how-to-guides) **参考** — 权威资料： - [命令](docs/COMMANDS.md) - [配置](docs/CONFIGURATION.md) - [CLI 工具](docs/CLI-TOOLS.md) **说明** — 概念与设计决策： - [上下文工程](docs/explanation/context-engineering.md) - [阶段循环](docs/explanation/the-phase-loop.md) - [架构](docs/ARCHITECTURE.md) 完整目录：[docs/README.md](docs/README.md)。其他语言：[日本語](README.ja-JP.md) · [한국어](README.ko-KR.md) · [Português](README.pt-BR.md) · [简体中文](README.zh-CN.md)。 ## 为什么有效 大多数 AI 编程设置在规模化时会失败，因为上下文膨胀会悄无声息地降低输出质量，会话之间没有共享记忆，而且没有任何机制来验证代码是否实际有效。GSD Core 解决了这三个问题：繁重的工作在全新的 subagent 中运行，像 `STATE.md` 和 `CONTEXT.md` 这样的结构化 artifact 可以跨越会话边界保留，并且验证步骤会在宣布阶段完成之前，详细检查已构建的内容并生成修复计划。完整的原理说明请参阅 [docs/explanation/context-engineering.md](docs/explanation/context-engineering.md)。 遇到问题？请参阅 [docs/how-to/recover-and-troubleshoot.md](docs/how-to/recover-and-troubleshoot.md)。 ## 许可证 MIT 许可证。详情请参阅 [LICENSE](LICENSE)。

标签：AI编程助手, MITM代理, SOC Prime, 上下文工程, 开发工具, 文档结构分析, 暗色界面, 自定义脚本, 规范驱动开发, 软件开发框架