#  Spec-Driven

**Repository Path**: bzsome/spec-driven

## Basic Information

- **Project Name**:  Spec-Driven
- **Description**: sdd规范模板，ai开发
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-08
- **Last Updated**: 2026-07-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# SDD 软件设计规范

> 面向开发者的精简需求设计规范

## 目录结构

```
sdd/
├── README.md                          # 本文件，索引导航
├── Templates/                        # 模板资源
│   ├── 需求说明-模板.md
│   ├── 概要设计-模板.md
│   ├── 详细设计-模板.md
│   └── 任务清单-模板.md
├── 总览/                             # 全局索引
│   ├── 需求清单.md                   # 需求总清单
│   └── 状态看板.md                   # 需求状态追踪
└── 需求/                             # 需求目录（按编号）
    ├── 202607-001-xxx/              # 单个需求（年月-序号）
    │   ├── README.md                # 需求概述（必读）
    │   ├── 01-需求说明.md            # 需求文档
    │   ├── 02-概要设计.md            # 概要设计
    │   ├── 03-详细设计.md            # 详细设计
    │   └── 04-任务清单.md            # 任务清单
    ├── 202607-002-xxx/
    │   └── ...
    └── ...
```

## 设计原则

### 1. 以需求为基本单元
每个需求文件夹包含该需求的完整设计文档，形成自包含单元。

### 2. 精简流程
```
需求确认 → 概要设计 → 详细设计 → 任务清单 → 编码
    ↓           ↓           ↓           ↓
 01-需求说明   02-概要设计  03-详细设计  04-任务清单
```

### 3. 开发进度
每份文档记录当前阶段进度，从需求说明到任务清单逐步推进。

### 4. 编号规则
- 格式：`YYYYMM-NNN`（年月-序号）
- 示例：`202607-001`（2026年7月第1个需求）
- 命名格式：`202607-001-用户登录`（编号-简短描述）

## 使用说明

### 新增需求
1. 确定需求创建年月和当月序号
2. 在 `需求/` 下创建新文件夹，命名：`YYYYMM-NNN-名称`
3. 复制 `Templates/` 中的模板到新文件夹
4. 填写需求说明
5. 完成后更新 `总览/需求清单.md`

### 设计流程
1. **需求说明** - 明确"做什么"，包含背景、用户故事、验收标准
2. **概要设计** - 明确"怎么做"，包含方案概述、接口设计、数据模型
3. **详细设计** - 明确"具体实现"，包含类/函数设计、算法、边界处理
4. **任务清单** - 拆解为可执行任务，明确验收标准和工时

---

*本规范适用于非大型项目，聚焦核心设计文档，避免过度设计。*