# Spec-Driven Development Guide **Repository Path**: stream-learning/spec-driven-development-guide ## Basic Information - **Project Name**: Spec-Driven Development Guide - **Description**: Spec-Driven Development 团队接入指南 - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-19 - **Last Updated**: 2026-11-19 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # Spec-Driven Development Guide (SDD) 规格驱动开发团队接入指南 ## 项目简介 Spec-Driven Development(SDD)规格驱动开发是一套帮助团队规范需求、设计与实现流程的方法论与工具集。本项目提供了完整的团队接入指南、标准化模板以及评审流程定义,旨在提升需求可追溯性、降低实现偏差、提高代码质量。 ## 核心特性 - **双目录方案**:支持 Spec-Kit(推荐团队/审计/长期维护)与 OpenSpec(推荐存量系统/频繁迭代)两种风格 - **标准化工作流**:6 步标准流程,每步产出物明确 - **分级通道机制**:根据变更类型选择不同处理流程 - **评审门禁**:工具化的评审检查,不依赖自觉性 - **开箱即用模板**:包含 spec.md、plan.md、tasks.md、PR 模板等 ## 快速开始 ### 1. 初始化脚手架 ```bash chmod +x init-sdd-scaffold.sh ./init-sdd-scaffold.sh ``` ### 2. 选择目录方案 | 方案 | 适用场景 | 路径 | |------|----------|------| | Spec-Kit(推荐) | 新团队/需审计/长期维护 | `specs/features/` | | OpenSpec | 存量系统/频繁局部迭代 | `openspec/changes/` | ### 3. 新功能开发流程 1. **生成脚手架** - 使用模板创建 spec.md 2. **选择通道** - 新功能选 `specs/features/`,存量改造选 `openspec/changes/` 3. **填写规格文档** - 按顺序:Why → Non-goals → 验收标准(AC) 4. **评审** - 使用 spec-review-checklist.md 走评审,状态改为 Approved 5. **编码与提交** - 写 plan.md/tasks.md,编码,勾任务,发 PR ## 文件结构 ``` ├── README-SDD.md # SDD 团队接入完整指南 ├── init-sdd-scaffold.sh # 脚手架初始化脚本 └── pull_request_template.md # PR 模板 ``` ## 核心概念 ### 验收标准(AC) 规格文档的核心部分,必须满足: - 可验证 - 可测试 - 明确具体 ### 评审门禁 - 规格文档状态为 `Approved` 方可进入开发 - PR 提交时必须关联已批准的规格文档 - 使用 PR 模板进行自检 ### 分级通道 | 通道 | 适用场景 | 流程 | |------|----------|------| | Full Channel | 新功能/重大重构 | 完整 6 步流程 | | Fast Channel | 小优化/Bug修复 | 简化流程 | | Hotfix | 紧急修复 | 豁免说明即可 | ## 文档目录(README-SDD.md 章节) 0. 一分钟理解 SDD 1. 目录约定(二选一) 2. 标准工作流(6 步) 3. 分级通道 4. 评审门禁 5. 角色职责(RACI) 6. 新人上手 5 步 7. 常见错误与对策 8. 度量指标 9. 工具栈建议 10. 仓库文件清单 11. 首次落地检查表 ## 使用建议 - **新团队**:建议从 Spec-Kit 风格开始,配合完整流程 - **存量项目**:可采用 OpenSpec 风格,逐步规范化 - **紧急修复**:使用 Hotfix 通道,但需补充豁免说明 ## 贡献指南 1. Fork 本仓库 2. 创建特性分支 (`git checkout -b feature/xxx`) 3. 提交更改 (`git commit -m 'Add xxx'`) 4. 推送分支 (`git push origin feature/xxx`) 5. 创建 Pull Request ## 许可证 本项目内容仅供团队内部使用与学习参考。