SDD 专家指南

适合对象:能设计 SDD 体系,能跨项目推广,能持续优化方法论

你需要知道什么?

1. SDD 不是银弹,是工程纪律

小项目可以简化流程

大项目必须严格执行

关键是要"适配场景",不是"死守流程"

2. 宪法体系的层次化设计

  • 企业级宪法(所有项目遵守)
  • 领域级宪法(特定业务线遵守)
  • 项目级宪法(当前项目特定约束)

3. SPEC 质量度量体系

  • 完整性:是否覆盖所有必要维度
  • 一致性:各阶段是否相互矛盾
  • 可测试性:验收标准是否可验证
  • 可追溯性:需求→代码→测试是否可追踪

4. SDD 与 DevOps 的融合

  • • SPEC 作为 CI/CD 的检查点
  • • 自动化验证 SPEC 合规性
  • • 持续改进 SPEC 模板

专家的核心价值

专家的责任

范例对比:任务(Tasks)

❌ 差的任务

# 任务列表

1. 创建项目
2. 写登录接口
3. 写测试
4. 部署

任务太粗略,无法分配

没有依赖关系

没有验收条件

无法跟踪进度

✅ 好的任务

# 任务列表:用户登录服务

## Phase 1:基础框架

### Task 1.1:项目初始化
**负责人**:张三  
**预计工时**:2 小时  
**依赖**:无  

**任务内容**:
- 创建 FastAPI 项目结构
- 配置 pyproject.toml
- 设置 pre-commit hooks

**验收条件**:
- [ ] 项目能正常启动
- [ ] 能通过 /health 接口
- [ ] pre-commit 检查通过

---

### Task 1.2:数据库连接
**负责人**:张三  
**预计工时**:3 小时  
**依赖**:Task 1.1  

**任务内容**:
- 配置 SQLAlchemy 连接池
- 创建数据库迁移脚本
- 编写用户模型

**验收条件**:
- [ ] 能连接数据库
- [ ] 能执行迁移
- [ ] 用户表创建成功

---

## Phase 2:核心功能

### Task 2.1:密码登录接口
**负责人**:李四  
**预计工时**:4 小时  
**依赖**:Task 1.2  

**任务内容**:
- 实现 POST /api/v1/auth/login
- 密码验证逻辑
- JWT Token 生成

**验收条件**:
- [ ] 正确密码返回 Token
- [ ] 错误密码返回 401
- [ ] Token 包含用户 ID 和角色

---

### Task 2.2:登录失败计数
**负责人**:李四  
**预计工时**:3 小时  
**依赖**:Task 2.1  

**任务内容**:
- Redis 记录失败次数
- 3 次失败后锁定账号
- 15 分钟后自动解锁

**验收条件**:
- [ ] 失败 3 次后返回"账号已锁定"
- [ ] 锁定 15 分钟后自动恢复
- [ ] Redis 中有失败计数记录

---

## Phase 3:测试与部署

### Task 3.1:单元测试
**负责人**:王五  
**预计工时**:6 小时  
**依赖**:Task 2.2  

**任务内容**:
- 登录接口单元测试
- 密码加密测试
- Token 生成测试

**验收条件**:
- [ ] 测试覆盖率 > 80%
- [ ] 所有测试通过
- [ ] CI 集成

---

### Task 3.2:Docker 化部署
**负责人**:赵六  
**预计工时**:4 小时  
**依赖**:Task 3.1  

**任务内容**:
- 编写 Dockerfile
- 编写 docker-compose.yml
- 配置健康检查

**验收条件**:
- [ ] 容器能正常启动
- [ ] 能通过健康检查
- [ ] 数据卷正确挂载

每个任务有负责人工时估算

有明确的依赖关系

有具体的验收条件

可以跟踪进度

可以并行分配

快速自查清单

宪法自查

  • ☐ 每条原则是否具体可执行?
  • ☐ 是否有明确的验收标准?
  • ☐ 是否有禁止行为清单?
  • ☐ AI 能否根据约束生成合规代码?

规范自查

  • ☐ 是否使用用户故事格式?
  • ☐ 是否有 Given-When-Then 场景?
  • ☐ 是否有功能性验收标准?
  • ☐ 是否有非功能性要求?

计划自查

  • ☐ 是否有选型理由?
  • ☐ 是否有架构设计?
  • ☐ 是否有数据模型?
  • ☐ 是否有 API 设计?

任务自查

  • ☐ 每个任务是否有负责人?
  • ☐ 是否有依赖关系?
  • ☐ 是否有验收条件?
  • ☐ 是否可以并行分配?

常见问答

Q1:小项目也需要四阶段吗?

可以简化,但不能跳过。小项目可以:

  • • 宪法:3-5 条核心原则
  • • 规范:1-2 个核心场景
  • • 计划:技术选型 + 关键设计
  • • 任务:3-5 个核心任务

Q2:SPEC 写多久合适?

根据项目规模:

  • • 小项目(1 周):SPEC 半天
  • • 中项目(1 月):SPEC 1-2 天
  • • 大项目(3 月+):SPEC 3-5 天

Q3:SPEC 可以修改吗?

可以,但要记录变更原因。SPEC 不是一成不变的,但修改要有据可查。

Q4:AI 生成的 SPEC 能用吗?

能用,但要人工审核。AI 生成的 SPEC 是起点,不是终点。需要根据实际情况调整。

上一篇:精通篇 返回首页