如何编写开发软件规范

明确了解用户需求，对软件的成功设计与开发十分重要。如果需求无法确切反映终端用户的需要，就会发生误解与错误的连锁反应，使产品开发完全失败。

这时就需要制订规范。规范说明如何满足用户的需要：它使需求具体化，定义产品质量，并详细描述产品设计与界面。

通常，规范可分为以下两类：

功能性规范：这些规范从终端用户的角度说明产品的功能。例如，微软Word这样的字处理器的功能应为“用特别的格式处理文字与图片，并将其保存在硬盘上。”

设计规范：这些规范说明软件如何满足功能性规范的要求。同样，在微软Word中，工具栏与菜单的位置与功能是字处理器设计规范的一部分。

以下是规范文件的主要内容框架。

绪论

意图与范围：总结文件内容及描述对象。

目标读者：说明文件的读者。

假设与依赖：软件及其操作假设列表，包括软件环境与平台。

风险：必须考虑的任何风险或费用。

限制：影响软件设计的限制列表——包括兼容性与互用性问题、标准、最低性能预测与功能限制。

目标与指导方针：支配设计过程的目标、规则与指导方针。

参考文献：规范文件需要引用的相关文件或历史数据。

术语表：重要的术语、首字母缩略词或缩写词。

修订记录：文件的修订次数、由谁修订及修改范围记录。

功能规范

产品构架：本部分说明产品构架——进程流程、系统特色与软件产品设计。应使用图表、流程图或应用案例/情景进一步说明产品构架。

开发方法：本部分简单说明软件设计所应用的方法或步骤。

特色：这个部分提供软件特色信息。

◆ID：特色唯一的识别号码

◆审核状态：特色的状态（已批准或正在审核）

◆所有者：这个特色的主要联系点

用户组/职位：本部分包括对终端用户及他们如何应用产品的详细说明；并说明每种类型的用户在组织内的职位，以及产品的哪些部分对他们最为重要。

设计规范

界面：这个部分讨论软件界面，用户界面与通信协议。对于用户界面，屏幕截图与说明性图表有助于吸引读者，使概念明白易懂。

政策与策略：这部分讨论整个系统操作以外的设计政策。其可能包括编码惯例、软件维护规划、编译方法、软件测试规划等。

详细的系统设计：本部分从以下类别说明软件的各个组件：

◆类型：是文件、函数、模块、类或对象

◆描述：组件的语法意义

◆功能：组件的主要功能或行为

◆组成：简单说明子组件

◆ 限制：相关的限制或约束

◆ 界面：界面设计问题

依赖：成功运行组件所需的资源列表，以及依赖这些组件才能成功运行的组件列表。

注：你还可以添加详细子系统设计部分，它与上述主要组件子组件所包含的信息相同。

根据软件产品与其开发组织的特殊要求，上面列出的各个部分会稍有差异。但是，这个文件所表达的基本信息大体相同。既然你已经了解这些信息，你可以着手为下一个项目建立一个规范。

（责任编辑 火凤凰 sunsj@51cto.com  TEL：（010）68476636-8007）