规范驱动开发（Spec-Driven Development，SDD）是一种开发方法，其中软件规范成为指导开发每个阶段的唯一事实来源。与代码优先方法不同，代码优先方法是在编写文档之前先进行实现，SDD 强制要求在编写任何一行生产代码之前创建、验证和批准详细的规范（例如 API 契约、架构计划和验收标准）。

这种规范优先的方法消除了歧义，减少了返工，并确保每个开发人员都从完全相同的蓝图中构建相同的系统。

规范驱动开发（SDD）的核心组件

规范驱动开发（SDD）基于四个基础文档，这些文档构成了你的开发契约：

1. 规范文档

对每个系统组件的详细、无歧义的描述。对于 API，这意味着具有模式、示例和验证规则的 OpenAPI 规范。

2. 架构计划

系统组件、数据流和基础设施决策的可视化和文本文档。

3. 任务分解

将规范分解为具有明确验收标准的可实现任务。

4. 实施指南

确保代码库一致性的编码标准、模式和约束。

规范驱动开发（SDD）的最佳实践规范优先，代码其次：在获得批准的规范之前，永远不要开始编写代码。单一事实来源：一个规范文件，处处引用。自动化验证：每次提交都与规范进行测试。利益相关者审查：非技术利益相关者必须批准规范。版本控制一切：规范、架构和指南都要版本化。保持规范活跃：需求变更时更新规范，而不仅仅是代码。使用代码生成：从规范生成代码、客户端和测试。强制执行契约：违反规范的构建失败。

规范驱动开发（SDD）将软件开发从一个被动的过程转变为一个可预测、高质量的工作流。通过使规范成为指导实现、测试和验证的中心文档，团队消除了歧义，减少了返工，并更有信心地更快交付产品。

关键见解：规范不是你在编程后编写的文档 —— 它们是你在编程前编写的契约。它们成为可执行的文档，可以生成测试、验证实现，并自动检测漂移。