需求分析师如何撰写需求规格说明书？

本文将分享一般的需求说明书该如何撰写，有哪些格式，需要注意什么等方面，力求使需求说明书看起来规范、专业。

需求分析师的一个主要工作就是写需求说明书。

国内对于需求说明书的格式并没有一套标准规范，每家公司有每家公司自己的需求说明书格式，在我从事的三家公司，我写过三种格式不同的需求说明书，这样造成的一个后果就是因为没有一套标准格式的需求说明书，假如去其他公司的话，又得抛弃原有的书写格式，重新习惯其他公司的需求说明书格式。

这样，对于一个有经验的需求分析师而言，在书写需求说明书这块，他就会和新人没有什么差别，无优势可言。

只有不断的总结，才能进步。

本文将分享一般的需求说明书该如何撰写，有哪些格式，需要注意什么等方面，力求使需求说明书看起来规范、专业。

一、文档结构

1. 首页

先说需求说明书的首页，首页展示本公司的基本信息、需求说明书的标题，如XX产品需求规格说明书，和文档编号、编写人、模块名称、部门、保密等级、日期、版权说明等。

2. 修订页

修订页的作用是记录需求说明书版本的变更，在跟客户沟通需求的时候，需求可能会变更，每一次修订，都需记录下来，作为留痕。

修订页展示的内容包括编号、章节名称、修订内容简述、修订日期、修订前版本号、修订后版本号、修订人、批准人。

3. 目录

目录即是需求说明书正文的内容，包含了引言、项目概述、业务需求、附录。

 （1）引言：展示编写目的、范围、定义和参考资料。

• 编写目的：说明编写这份软件需求说明书的目的，指出预期的读者范围。
• 范围：待开发的软件系统的名称；说明软件将干什么，如果需要的话，还要说明软件产品不干什么；描述所说明的软件的应用，尽可能精确地描述所有相关的利益、目的、以及最终目标。
• 定义：列出本文件中用到的专门术语的定义和缩写词的原词组。

（2）项目描述：如果是项目需求，简要描述一下项目的概况，如项目的背景，项目的周期等等。

• 产品描述：叙述该项软件开发的意图、应用目标、作用范围以及其他应向读者说明的有关该软件开发的背景材料。如果开发的系统与其他系统有对接，则还应该本系统与其他系统之间的关系，用方框图表示。
• 产品功能：系统包含的模块，并简要描述下各模块的功能。描述产品功能模块的作用是将系统的范围定义清楚，一共有多少个模块，以便甲乙两方明确本次项目的边界。

（3）业务需求：用户提出的需求

• 功能介绍：描述功能要达到的目标、所彩的方法和技术，还应清楚说明功能意图的由来和背景。
• 流程图：如果涉及到流程，除了文字以外，还需附上流程图
• 数据项描述：展示字段、字段类型（文本、日期、数值、枚举值等）、数据来源、备注，开发看到数据项描述能定义数据库表中的字段。
• 界面展示：原型图输出，用原型图方式呈现文字描述的功能，每张原型图下面可以备注功能的路径，以便开发明白该原型图在哪个模块的哪个菜单。

（4）附录：对一个实际的需求规格说明来说，若有必要应该编写附录。

附录包括有助于理解需求说明的背景信息、用户历史、背景、经历和操作特点、原始需求、需求调研记录等等。需要注意的是当包括附录时，需求说明必须明确地说明附录只作为参考，不作为正式的需求。

因为有时候一些原始需求，在需求沟通过程或者其他原因，可能会不做，原始的需求和正式要开发的需求不一定是相同的，所以要用文字说明附录不作为正式开发的需求，也不作为验收的标准。

最后，如果需求说明书需要用户签名，还需在后面写上用户公司名称、日期，以及本公司名称和日期。

以上是文档结构部分，为了使一份需求说明书看起来专业，还需注意细节部分。

二、文档细节

需求说明书可以向开发和用户展现需求分析师的实力，专业的需求说明书能体现需求分析师的专业水平，可以说需求说明书是需求分析师的一件“外衣”，专业的需求分析师写出的需求不仅是用户开发能看懂，而且整篇文档的结构完整，细节也相当注意。

 作者：Vi-Vi-Fu