1.3 规范驱动开发 SDD(Specification-Driven Development)

1.3.1 为什么AI编程需要”规范”

你有没有过这种经历:在淘宝买衣服时,你描述”我要一件好看的衣服”,结果收到的和你想的完全不一样?这就是沟通不精准导致的。

AI编程也是一样。如果你告诉AI”帮我做一个网站”,它可能做出一个和你期望完全不同的东西。”垃圾进,垃圾出” —— 模糊的需求必然导致不准确的结果。

规范(Specification)就是你和AI之间的”合同”,它明确地写清楚:

  • 要做什么(功能需求)
  • 怎么做(技术方案)
  • 做到什么程度(质量标准)

有了这份”合同”,AI才能精准地理解你的意图。

1.3.2 需求规范:PRD文档

PRD(Product Requirements Document,产品需求文档)描述的是”要做什么”。

用户故事(User Story)格式:

作为一个 [角色],
我希望 [功能],
以便 [价值/目的]。

例如:

作为一个博客读者,
我希望能按标签筛选文章,
以便快速找到我感兴趣的内容。

验收标准(Acceptance Criteria)格式:

Given(前提条件):系统中有20篇文章,其中5篇标记了"Python"标签
When(操作):用户点击"Python"标签
Then(预期结果):页面只显示这5篇标记了"Python"标签的文章

用AI辅助生成PRD的Prompt:

这是一个非常实用的技巧 —— 你可以让AI帮你把模糊的想法变成结构化的需求文档:

我想做一个个人书签管理工具。
​
请帮我生成一份完整的PRD文档,包含:
1. 项目概述(一句话描述)
2. 目标用户
3. 核心功能列表(按优先级排列:Must Have / Should Have / Nice to Have)
4. 每个功能的用户故事和验收标准
5. 非功能需求(性能、安全、兼容性)
​
请用Markdown格式输出。

提示:在第五部分的项目实操中,我们会完整演示如何用这个方法生成PRD文档。

1.3.3 技术规范:SPEC文档

SPEC(Technical Specification,技术规范文档)描述的是”怎么做”。

一个完整的SPEC文档包含:

图片[1]-1.3 规范驱动开发 SDD(Specification-Driven Development)-大赛人网

让AI从PRD自动生成SPEC的Prompt:

基于以下PRD文档,请生成对应的技术规范文档(SPEC):
​
[粘贴你的PRD内容]
​
要求:
1. 推荐技术选型并说明理由
2. 设计完整的数据模型(包含字段类型和关系)
3. 列出所有API接口(RESTful风格)
4. 给出建议的项目目录结构

1.3.4 质量规范

质量规范定义了”做到什么程度算合格”:

  • 编码规范:代码风格统一、命名规则、注释要求
  • 测试规范:需要覆盖哪些测试场景
  • 安全规范:输入验证、认证授权、数据保护

提示:对于初学者来说,不需要一开始就写完美的规范文档。从简单的PRD开始,随着项目变复杂再逐步完善。规范的核心价值在于 —— 让你和AI的沟通更精准。

1.3.5 规范文件的组织与管理

建议在项目根目录下创建一个 specs/ 文件夹,统一管理规范文件:

my-project/
├── specs/
│   ├── PRD.md         # 产品需求文档
│   ├── SPEC.md         # 技术规范
│   ├── ARCHITECTURE.md   # 架构设计
│   └── API.md         # API 接口文档
├── src/             # 源代码
├── CLAUDE.md         # 给Claude Code的项目说明(详见第二部分)
└── package.json

规范文件最大的价值之一是 —— 可以直接作为AI工具的上下文输入。当你把 SPEC.md 的内容提供给 Claude Code 时,它就能精准地按照你的技术方案来写代码。

© 版权声明
THE END
喜欢就支持一下吧
点赞11 分享
评论 抢沙发
头像-大赛人网
欢迎您留下宝贵的见解!
提交
头像-大赛人网

昵称

取消
昵称

    请登录后查看评论内容