SDD规范驱动开发

一：什么是SDD？

SDD（Specification Driven Development，规范驱动开发） 是一种先写"说明书"，再写代码的开发方法。

用 Spec 文档 作为 AI Agent 与人类开发者之间的"契约"，实现需求 -> 规格 -> 方案 -> 任务 -> 自动执行的端到端闭环。AI 不猜测、不发散，严格按照 Spec 执行代码实现。

二：整体流程

整个流程分为 两大阶段：

• 拆解阶段（人 + AI 协作）：PRD -> spec.md -> plan.md -> tasks.md
• 执行阶段（AI Agent 自动推进）：按 tasks.md 逐个实现 -> 测试 -> 标记完成

三：快速上手

前置条件（开始前 5 分钟）

开始前请确认：

1. 已能在 Cursor 中正常使用 AI 对话
2. 仓库可正常运行基础测试命令（至少有一组可执行测试）
3. 项目中已约定 Spec 目录（建议：.doc/specs/）
4. 团队已有最基本的工程护栏（如代码规范、测试要求、变更边界）

如果以上条件不满足，先补齐环境与规则，再执行 SDD。

Step 1：准备一个最小需求

先写一个范围很小、当天可完成的需求，建议满足：

1. 只涉及 1 个业务目标
2. 只改动 1-2 个模块
3. 验收标准可量化（例如"新增接口返回字段 X，测试通过"）

你可以把需求存为：.doc/prd/quickstart.md。

Step 2：触发需求拆解

在 Cursor 中发送：

@.doc/prd/quickstart.md 拆解需求

或直接发送：

基于这个需求生成 spec.md、plan.md、tasks.md，并逐步预览后再写入文件

Step 3：逐步确认三份文档

要求 Agent 按顺序预览并等待你确认：

1. spec.md：功能范围、验收标准、非范围项是否清晰
2. plan.md：架构分层、依赖关系、风险与回滚方案是否清晰
3. tasks.md：任务粒度、依赖关系、每项验收 checklist 是否可执行

确认后，文件应落在：.doc/specs/{feature-id}/。

Step 4： 执行与验证

触发执行：

@.doc/specs/{feature-id} 执行 spec

执行过程中重点观察三件事：

• 是否按依赖顺序推进任务
• 每个任务完成后是否有测试结果
• tasks.md 是否从 正确更新为 x

执行结束后，补跑一次回归测试（命令按项目约定）。

Step 5： 最小验收标准（DoD）

一次"跑通 SDD"至少满足：

• pec.md / plan.md / tasks.md 三件套完整存在
• 至少一个任务完成且有对应测试结果
• 任务状态已更新（不是口头完成）
• 测试通过，且无新增已知阻塞问题
• 变更可回滚（能明确说明回滚方式）

参考：Spec 驱动开发（SDD）流程总结