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)-大赛人网](https://www.dsrw.com/wp-content/uploads/2026/11/image-1823-1024x217.png)
让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
















请登录后查看评论内容