========================================================
软件行业 Spec 文档入门与实操指南（纯文本版）
一、Spec 是什么
Spec = Specification，中文叫“规格说明书”或“规约”。
它的本质是：把模糊的想法，变成无歧义的书面契约。
用来对齐产品、开发、测试、客户之间的理解。
Spec 回答三个问题：
- 做什么
- 怎么做
- 做到什么程度算完成
二、软件行业常见的 Spec 类型
- SRS（Software Requirements Specification，软件需求规格说明书）
- 说明系统“应该做什么”
- 包括功能、性能、接口、约束、验收标准
- PRD（Product Requirements Document，产品需求文档）
- 业务视角下的功能说明
- 包括用户故事、业务流程、页面逻辑
- Tech Spec（技术规格说明书）
- 说明“怎么做”
- 包括系统架构、模块划分、数据库设计、接口设计
- API Spec（接口规格说明书）
- 定义系统之间或前后端之间的接口
- 包括 URL、方法、参数、返回值、错误码
- Design Spec（UI/交互设计规格）
- 说明界面样式和交互细节
三、Spec 来自哪些理论与标准
- 系统工程思想
- 先设计、再实现、再验证
- 结构化分析与设计（SA/SD）
- 数据流图、数据字典
- 传统 SRS 的核心理论来源
- 面向对象分析与设计（OOAD）
- 用例驱动的需求写法
- IEEE 29148（原 IEEE 830）
- 国际通用的需求规格标准
- CMMI 与 ISO 标准
- 强调需求可追溯性、文档化管理
- 敏捷方法（Agile / Scrum）
- 用 User Story + Acceptance Criteria 代替厚重文档
四、合格 Spec 的基本特征
- 无歧义
- 完整（正常 + 异常 + 边界）
- 一致（前后不矛盾）
- 可验证（能写测试用例）
- 可追溯（需求 → 设计 → 代码 → 测试）
五、推荐学习书单（偏实操）
- 《软件需求（第3版）》Karl Wiegers & Joy Beatty
- 《软件需求最佳实践——SERU 过程框架原理与应用》徐锋
- 《科技文档写作实务》中兴通讯学院
- （可选）《Specification by Example》Gojko Adzic
六、SRS（需求规格）精简模板（可直接填空）
- 引言
1.1 目的
1.2 范围
1.3 读者对象
1.4 参考文档 - 总体描述
2.1 产品愿景
2.2 用户角色与特征
2.3 运行环境
2.4 假设与约束 - 功能需求
3.1 功能模块 A
3.1.1 功能描述
3.1.2 输入
3.1.3 处理逻辑
3.1.4 输出
3.1.5 异常与边界 - 非功能性需求
4.1 性能需求
4.2 安全需求
4.3 可用性需求 - 接口需求
5.1 用户界面
5.2 外部系统接口 - 其他需求
6.1 数据需求
6.2 合规与法律要求 - 验收标准
7.1 功能验收条件
7.2 性能验收条件
七、Tech Spec（技术设计）精简模板
- 引言
1.1 背景与目标
1.2 设计范围
1.3 术语说明 - 总体架构
2.1 系统架构说明
2.2 模块划分与职责
2.3 技术选型说明 - 模块设计
3.1 模块 A
3.1.1 职责说明
3.1.2 关键接口
3.1.3 处理流程 - 数据设计
4.1 数据库表结构
4.2 关键字段说明
4.3 数据一致性策略 - 接口设计
5.1 内部接口
5.2 外部接口 - 非功能性设计
6.1 性能设计
6.2 安全设计
6.3 可维护性设计 - 部署与运维
7.1 部署拓扑
7.2 依赖环境
7.3 回滚方案
八、新手实操建议
- 先模仿现有文档
- 用模板填空
- 每写一条需求，问自己：
- 测试能写用例吗？
- 开发能写代码吗？
如果不能，就继续细化。
