GSD第一个项目实战从一句话需求到可运行软件的Spec驱动开发指南【免费下载链接】gsd-2A powerful meta-prompting, context engineering and spec-driven development system that enables agents to work for long periods of time autonomously without losing track of the big picture项目地址: https://gitcode.com/gh_mirrors/gs/gsd-2GSD 是一款强大的 Spec 驱动开发系统通过元提示meta-prompting、上下文工程和规范驱动开发spec-driven development让 AI 编程代理能够长时间自主工作而不丢失项目全貌。本文将带你完成第一个 GSD 项目从一句话需求出发经过规格化、任务拆解最终让 AI 代理自动交付可运行软件。什么是 Spec 驱动开发传统做法是想到哪写到哪AI 代理写着写着就忘了目标。Spec 驱动开发的核心思路是先把需求写清楚再让 AI 按规范干活。GSD 作为你与 AI 编程代理之间的编排层详见 VISION.md负责四件事规划、执行、验证、交付。你只需要描述要构建什么它处理怎么构建。准备工作快速安装 GSD 安装 GSD 只需满足三个前置条件依赖最低版本推荐版本Node.js22.0.024 LTSGit2.20最新版LLM API Key任意支持的提供商Anthropic (Claude)一条命令全局安装支持 macOS / Windows / Linuxnpm install -g gsd-pi然后在项目目录中配置你的 LLM 提供商并启动会话gsd config # 交互式配置向导 cd ~/my-project gsd # 启动会话完整的多平台安装说明见 docs/user-docs/getting-started.md。第一步把一句话需求变成规格说明这是 GSD 项目中最关键的一步。假设你的需求只有这么一句话我要一个能把 CSV 转成 JSON 的命令行工具。GSD 内置了规范模板 gsd-orchestrator/templates/spec.md它的结构非常简洁只有四个部分What是什么——一句话说清产品做什么要求具体一个把 CSV 转成 JSON 的 CLI 工具而不是一个数据转换解决方案Requirements需求——用户可观测的具体行为比如用户可以用--indent参数控制缩进Technical Constraints技术约束——语言、框架、外部依赖、运行环境Out of Scope范围外——明确排除项防止范围蔓延 新手建议把Out of Scope写具体是防止 AI 代理过度发挥最有效的手段。第二步启动项目讨论流在空目录或项目目录中输入/gsd进入 Step 模式。GSD 会读取当前目录状态并自动判断下一步动作没有.gsd/目录→ 自动进入讨论流引导你描述项目愿景有里程碑、没有路线图→ 讨论或研究该里程碑有路线图、切片待处理→ 规划下一个切片或执行任务任务进行中→ 从上次中断处恢复讨论过程中GSD 会帮你把零散的对话整理成结构化文档.gsd/ PROJECT.md — 项目当前是什么活文档 REQUIREMENTS.md — 需求契约active/validated/deferred DECISIONS.md — 架构决策日志 KNOWLEDGE.md — 手动规则 模式与经验 STATE.md — 一目了然的状态面板 milestones/M001/ — 里程碑与切片计划第三步里程碑 → 切片 → 任务 三层拆解GSD 用三级层级把工作拆成 AI 能可靠执行的颗粒度详见 gitbook/core-concepts/project-structure.mdMilestone里程碑 → 一个可交付的版本含 4-10 个切片 Slice切片 → 一个可演示的纵向能力含 1-7 个任务 Task任务 → 一个上下文窗口能装完的工作单元铁律只有一条一个任务必须能装进单个 AI 上下文窗口装不下就拆成两个。这就是 GSD 能长时间自主工作却不忘大局的秘密——每个任务都在全新的上下文窗口中运行所有全局信息通过预注入的上下文提示带给 AI。第四步让 GSD 自动跑完全程当里程碑和路线图就绪后输入一条命令即可放权/gsd autoGSD 会自动进入循环机制详见 docs/user-docs/auto-mode.mdPlan— 扫描代码库、研究文档、把切片拆解为任务Execute— 每个任务在全新会话中执行Complete— 写总结、生成 UAT 测试脚本、提交有意义的 commitReassess— 校验路线图是否仍然合理Repeat— 直到里程碑完成最后通过验证门禁封版推荐用双终端工作流终端 1 执行/gsd auto让它跑终端 2 随时介入/gsd status # 查看进度看板 /gsd discuss # 讨论架构决策 /gsd capture API 加个限流 # 随手记录想法任务间隙自动分诊 按Escape可随时暂停状态保留再执行/gsd auto无缝恢复CtrlAltG弹出实时进度面板含成本与 token 消耗。交付检查验证不是靠 AI 自觉GSD 的验证是机械强制执行而非提示词约束。你可以在偏好中配置每个任务执行后自动运行的检查命令verification_commands: - npm run lint - npm run test失败会自动触发修复重试默认最多 2 次。配合崩溃恢复、超时监督软/空闲/硬三级超时和卡死检测/gsd auto甚至支持睡前启动、醒来验收的过夜执行。实用命令速查命令用途/gsdStep 模式一步步执行并暂停确认/gsd auto自主模式规划→执行→提交全自动/gsd status进度看板里程碑/切片/成本/gsd pause//gsd stop暂停 / 停止自动模式/gsd undo回滚上一个已完成单元/gsd visualize打开交互式工作流可视化/gsd export --html生成交付里程碑的 HTML 报告全部命令参考 docs/user-docs/commands.md。下一步 深入自动模式docs/user-docs/auto-mode.md 成本控制与 token 优化docs/user-docs/cost-management.md 浏览器界面gsd --web见 docs/user-docs/web-interface.md VS Code 扩展侧边栏看板 gsd聊天参与者见 vscode-extension/README.md从一句话需求到可运行软件GSD 把AI 代理长期自主开发这件难事变成了写清楚 Spec 之后的一键执行。现在打开终端写下你的第一句话需求吧。【免费下载链接】gsd-2A powerful meta-prompting, context engineering and spec-driven development system that enables agents to work for long periods of time autonomously without losing track of the big picture项目地址: https://gitcode.com/gh_mirrors/gs/gsd-2创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
