Spec（规格文档）

Spec = Specification，中文常叫：规格说明书 / 需求规格文档 / 技术方案文档

简单说：
它是一份把“要做什么、怎么做、做成什么样”写清楚的正式文档，用来统一所有人的理解，避免做出来的东西和预期不一样。
一、核心作用

1. 统一认知
产品、设计、开发、测试都看同一份 Spec，避免各说各话。

2. 明确边界
写清楚功能范围、输入输出、逻辑规则、异常情况。

3. 作为验收依据
最终产品符不符合要求，就对照 Spec 来判断。

4. 减少返工
先想清楚、写清楚，再动手开发。

二、一份常见 Spec 里会有什么？

以软件/产品为例：

• 项目/功能背景、目标

• 需求描述（用户要什么）

• 功能详细逻辑（流程图、状态机）

• 接口定义（API、参数、返回值）

• 数据结构、数据库设计

• UI/交互规则

• 异常处理、边界 case

• 测试要点、验收标准

三、不同场景下的 Spec

• 产品 Spec：讲清楚产品功能、流程、用户体验

• 技术 Spec：讲架构、模块、接口、实现方案

• 硬件 Spec：尺寸、材料、性能、电气参数

• 接口 Spec：协议、字段、格式、调用规则