GSD-2 Full Project 工作流模板：五阶段规格驱动开发的完整实践指南

人工智能AI Agent代码智能体Agent 编排CLIAI 应用【免费下载链接】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点击查看免费下载本篇技术指南围绕 gsd-2 仓库内置的full-project工作流模板展开讲解如何用一条命令把任意绿地greenfield项目或大型功能从零引导进 GSD 的完整规划体系初始化、讨论、规划、执行、验证五大阶段全程由 Agent 接管Roadmap / Milestone / Slice / Task 四层结构落盘到.gsd/目录实现长周期自主开发而不丢失全局视图。读完本文你将掌握full-project模板的元数据含义、五阶段管线的具体产出物、底层路由机制/gsd start full-project→/gsd init→/gsd auto以及GSD-WORKFLOW.md中定义的文件格式与状态管理规范能够直接在项目中跑通这套规格驱动开发流程。模板是什么一条命令拉起完整的 GSD 仪式full-project是 GSD 工作流模板家族中级别最高的一个定位是完整仪式full ceremony入口。它面向绿地项目或需要完整规划装置的大型功能一次覆盖 Roadmap、Milestone、Slice、Task、研究、规划、执行与验证的全部环节。模板本体位于 full-project.md核心由三部分组成template_meta元数据块、purpose用途声明与process路由协议。template_meta 元数据解析模板头部声明了自身的关键属性这些字段同时被注册表 registry.json 使用字段值含义namefull-project模板 ID也是/gsd start后跟的命令名version1模板版本号modeauto-milestone执行模式以 Milestone 为单位的自动执行requires_projecttrue必须在已有项目目录中运行artifact_dir.gsd/所有规划产物写入的目录其中mode: auto-milestone是四种工作流模式oneshot、yaml-step、markdown-phase、auto-milestone中唯一的非遗留模式——在 workflow-templates.ts 中isLegacyWorkflowMode()的判断逻辑正是只要不是auto-milestone就视为遗留引擎。注册表中该模板还带有两条元数据triggers: [new project, greenfield, from scratch, build an app, create a new]—— 当用户输入包含这些短语时自动检测机制会优先命中本模板estimated_complexity: high—— 属于高复杂度流程适合需要完整规划的项目。autoDetect()对描述文本做分词打分多词短语命中得分更高每个词计 2 分单次命中累计分 ≥4 为high置信度≥2 为medium否则为low。因此build an app这类双词短语能可靠地触发本模板的自动匹配。五阶段管线从初始化到验证的完整闭环模板将整条开发链路划分为五个阶段1. init — 初始化项目检测技术栈创建 .gsd/ 2. discuss — 定义需求、决策与架构 3. plan — 创建包含里程碑与切片slices的路线图 4. execute — 执行切片每个切片内依次进行 研究 → 规划 → 实现 → 验证 5. verify — 里程碑级验证与完成这与 GSD-WORKFLOW.md 中定义的手动引导协议完全一致work 以Milestone一个可交付版本1-10 个切片→ Slice一个可演示的纵向能力1-7 个任务→ Task一个恰好能装进单个上下文窗口的工作单元的层级推进并有一条铁律——一个任务必须能在单个上下文窗口内完成装不下就拆成两个任务。每阶段落盘的文件五阶段不是空泛的仪式每个阶段都有确定性的文件产出。以M001、S01、T01为例项目根目录.gsd/下会形成.gsd/ STATE.md # 仪表盘永远最先读派生缓存运行时生成已 gitignore DECISIONS.md # 追加式决策登记表 CODEBASE.md # 生成的代码库地图缓存GSD 自动刷新 milestones/ M001/ M001-ROADMAP.md # 里程碑计划复选框即状态 M001-CONTEXT.md # 可选discuss 阶段沉淀的用户决策 M001-RESEARCH.md # 可选代码库/技术研究 M001-SUMMARY.md # 里程碑汇总随切片完成而更新 slices/ S01/ S01-PLAN.md # 本切片的任务分解 S01-CONTEXT.md # 可选切片级用户决策 S01-RESEARCH.md # 可选切片级研究 S01-SUMMARY.md # 切片摘要完成时写入 S01-UAT.md # 非阻塞人工测试脚本完成时写入 continue.md # 临时文件中断时的恢复点 tasks/ T01-PLAN.md # 单个任务计划 T01-SUMMARY.md # 带 frontmatter 的任务摘要关键文件格式速览M001-ROADMAP.md用复选框表达切片状态行内元数据标签risk:与depends:[]会被解析器读取- [ ] **S01: Slice Title** risk:low depends:[] After this: what the user can demo when this slice is done. - [ ] **S02: Another Slice** risk:medium depends:[S01] After this: demo sentence.Roadmap 还必须包含## Boundary Map小节——这是规划阶段强制产出的边界契约说明每个切片产出哪些接口/函数/类型、消费上游切片的哪些产物。它迫使团队在实现前先想清楚切片边界并为下游切片提供确定性的对接目标从而让切片是否真正连接可以被机械化验证。T01-PLAN.md是验证机制能机械执行的关键。它的 Must-Haves 分三类Truths任务完成时必须为真的可观察行为用户能用邮箱密码注册Artifacts必须真实存在且非桩代码的文件src/lib/auth.ts≥30 行导出generateToken、verifyTokenKey Links制品之间的关键接线login/route.ts通过 importgenerateToken连接auth.ts。路由机制模板如何进入标准 GSD 流水线模板文档明确说明自己是一个便捷入口convenience entry point它不重造轮子而是包装并路由到标准 GSD 流程。原文档给出的路由协议为若.gsd/不存在 → 运行/gsd init引导项目若.gsd/存在但尚无里程碑 → 通过/gsd discuss进入讨论阶段若里程碑已存在 → 通过/gsd auto或/gsd next恢复执行。源码中的实际路由实现这一路由协议在 commands-workflow-templates.ts 中有直接对应实现。当handleStart解析出templateId full-project时会检查gsdRoot(basePath)是否存在不存在 → 向 Agent 发送引导消息The user wants to start a full GSD project. Run/gsd initto bootstrap the project, then/gsd autoto begin execution.并触发一次对话轮次已存在 → 提示Project already initialized. Use/gsd autoto continue or/gsd discussto start a new milestone.。也就是说full-project是模板家族中唯一不创建独立 artifact 目录、不创建gsd/template/slug分支的模板——因为它把状态完全交给.gsd/与标准里程碑管线管理。auto 模式冲突保护由于工作流模板会自行派发消息并切换 git 分支GSD 在handleStart入口处做了保护性检查commands-workflow-templates.tsisAutoActive()为真时直接拒绝启动提示先Run /gsd pauseisAutoPaused()为真时放行并提示暂停的 auto 会话之后可用/gsd auto恢复。这保证了手动启动的工作流不会与正在运行的自动调度循环互相踩踏。深入标准 GSD 流水线Agent 如何长周期自主工作路由进入/gsd auto后由 GSD-WORKFLOW.md 定义的手动引导协议接管。这份文档要求任何会话开始时按固定顺序读取状态文件回答Whats next?.gsd/STATE.md—— 我们在哪下一个动作是什么活动里程碑的M###-ROADMAP.md—— 计划是什么哪些切片已完成M###-CONTEXT.md—— 里程碑级决策、参考路径与约束活动切片的S##-CONTEXT.md如存在活动切片的S##-PLAN.md—— 有哪些任务、哪些已完成.gsd/CODEBASE.md如存在—— 快速结构定位若任务中断读取活动切片目录下的continue.md恢复。六阶段执行协议实际执行按Discuss可选→ Research可选→ Plan → Execute → Verify → Summarize → Advance推进Discuss识别 3-5 个用户关心的灰区决策用ask_user_questions逐轮询问绝不虚构用户输入产出M###-CONTEXT.mdResearch在陌生代码/复杂集成场景下先行侦察产出含Dont Hand-Roll与Common Pitfalls两个反昂贵错误章节的M###-RESEARCH.md/S##-RESEARCH.mdPlan把愿景拆成 1-10 个可演示纵向切片按风险排序高风险优先验证可行性并强制编写 Boundary Map切片内再拆 1-7 个上下文窗口大小的任务Execute执行任务步骤用[DONE:n]标记进度做出架构/模式/库决策时追加进DECISIONS.mdVerify按验证阶梯逐级增强——Static文件存在/导出齐全/接线正确→ Command测试通过/构建成功/lint 干净→ Behavioral浏览器流/API 响应正确→ Human仅在无法自查时询问用户并产出带证据表格的验证报告。所有步骤都完成不算验证必须检查实际结果Summarize任务摘要带 frontmatterprovides、requires、affects、key_files、key_decisions等切片完成时压缩为S##-SUMMARY.md里程碑随切片推进持续更新M###-SUMMARY.md。状态管理STATE.md 只是派生缓存系统特别强调STATE.md不是真相来源只是一块便捷仪表盘。真正的真相来源是M###-ROADMAP.md→ 切片存在性与完成度S##-PLAN.md→ 切片内的任务T##-SUMMARY.md/S##-SUMMARY.md/M###-SUMMARY.md→ 各层压缩后的执行结果当文件之间不一致如 Roadmap 说切片已完成但任务摘要缺失时协议要求暂停并向用户呈报而不是自行臆断。上下文续接协议针对长周期自主开发的硬约束——上下文窗口有限——协议定义了continue.md续接文件上下文即将耗尽、会话结束或 CtrlC 时把milestone/slice/task/step/total_steps、已完成工作、剩余工作、决策及下一动作写入该文件恢复时读取并删除它一次性消费非永久存档直接从 Next Action 继续。同时下游任务注入摘要时有软上限总注入摘要上下文控制在约 2500 tokens优先从最高层级M###-SUMMARY.md开始链太大时先丢弃最旧/最不相关的摘要。这保证了长周期开发的每个新会话都能以干净的上下文切入而不因加载过多历史而劣化推理质量。实战操作如何在项目中启动 full-project方式一显式指定模板/gsd start full-project 为一个新的 SaaS 应用搭建完整项目命令解析逻辑在 workflow-templates.ts第一个词full-project会先按精确 key 命中注册表confidence: exact剩余部分作为描述文本注入工作流提示词。此外别名表把project、full也映射到full-project因此/gsd start project ...同样可达。方式二自动检测/gsd start build an app that tracks team OKRs输入中没有模板名时autoDetect()会对注册表中全部 27 个模板的 triggers 逐一打分。build an app与create a new是多词短语命中得分最高full-project会以high置信度被选中若出现多个候选命令会列出前 4 个让用户挑选。辅助命令命令作用/gsd start --list或/gsd start list列出全部模板及阶段/复杂度/gsd start --dry-run full-project 描述预览模板信息而不执行/gsd templates info full-project查看模板详细元数据阶段、触发词、产物目录/gsd start resume恢复进行中的工作流按STATE.json定位最近的活动相位/gsd start无参数且检测到进行中的工作流时会提示Run /gsd start resume to continue it.。这些子命令在 commands-bootstrap.ts 中提供了补全支持。需要说明的是由于full-project直接路由到标准 GSD 管线执行主体是auto-milestone模式因此模板自身的 git 分支创建逻辑gsd/full-project/slug会被跳过分支与提交策略由里程碑生命周期管理默认顺序提交在活动分支上git.isolation设为worktree或branch时使用milestone/MID隔离分支里程碑完成时 squash 合并回集成分支。与其他模板的定位差异full-project在注册表中estimated_complexity: high、requires_project: true与其余模板形成明确分工模板模式复杂度适用场景full-projectauto-milestonehigh绿地项目 / 需要完整规划装置的大型功能small-featuremarkdown-phasemedium轻量功能可选讨论与研究bugfixmarkdown-phaselow缺陷修复triage → fix → verify → shipspikemarkdown-phaselow研究、原型与评估hotfixmarkdown-phaseminimal应急修复最小仪式refactormarkdown-phasemedium系统化代码迁移选择原则很直接工作规模越大、仪式需求越高就越应该用full-project把整个生命周期托付给 GSD 的 Roadmap/切片机制而单点小改动则用轻量模板避免仪式负担。延伸阅读工作流模板本体full-project.md模板注册表全部 27 个模板的元数据与触发词registry.json模板解析与自动检测实现workflow-templates.ts/gsd start//gsd templates命令实现commands-workflow-templates.ts完整的 GSD 手动引导协议五阶段细节、文件格式、验证阶梯、Git 策略、上下文续接GSD-WORKFLOW.md命令补全定义commands-bootstrap.ts赞分享人工智能AI Agent代码智能体Agent 编排CLIAI 应用【免费下载链接】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点击查看免费下载相关推荐GSD 工作流模板Workflow Templates实战指南从 /gsd start 到自动化分阶段执行GSD 工作流模板Workflow Templates实战指南从 /gsd start 到自动化分阶段执行 导读 本文基于 gsd 2 仓库项目路径 g人工智能AI Agent代码智能体Agent 编排CLIAI 应用Serial Studio 规范驱动开发Spec-Driven Development从 Spec 模板到四阶段工作流实战指南Serial Studio 规范驱动开发Spec Driven Development从 Spec 模板到四阶段工作流实战指南 Serial Studio桌面应用数据可视化物联网GSD-2 Hotfix 工作流模板解析生产故障下的极简两阶段热修复实战指南GSD 2 Hotfix 工作流模板解析生产故障下的极简两阶段热修复实战指南 导读 本文围绕 GSD 2 内置的 hotfix 工作流模板 src/res人工智能AI Agent代码智能体Agent 编排CLIAI 应用上一篇5步掌握分布式AI训练Mistral 7B联邦学习实战指南下一篇5个革命性功能重塑你的炉石传说游戏体验HsMod深度解析创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考