知识卡片
规格说明书的四种基本信息,按时间顺序展开
规格说明书内部实际上包含四种性质不同的信息,理解它们各自的定位和先后顺序,能帮助团队判断自己当前到底缺的是哪一种、该由谁来撰写。第一种是”需求”:概述工作必须实现的所有要求和义务,理想情况下是一份描述最终结果、但不解释如何达成的成功条件列表,应该在设计流程开始之前就从远景文件中衍生出来。第二种是”功能规格说明书”:从客户角度描述特定场景下软件应有的行为,是设计流程的主要产物,用非技术语言详细说明事情应该如何运作,做得好的话可以简单到就是一系列带说明的屏幕截图。第三种是”技术规范”:详细说明实现功能规格说明书所需的工程方法,只有在描述最复杂或可能被复用的组件时才需要独立成文,很多情况下功能规格说明书本身的深度已经足够,不需要单独的技术规范。第四种是”工作项目列表”(大致对应工作分解结构WBS):由程序员完成,把实现功能规格说明书所需的每项工作分解到能以天或半天为单位估算的粒度,由首席程序员或项目经理负责评审整理。这四种信息本质上按时间顺序层层递进、彼此依赖,团队规模越大、项目越复杂,就越需要正式区分它们;在小团队中,这四种信息通常会被自然地合并进同一份文档。
结构图:
flowchart LR
A[需求<br/>要什么,衍生自远景文件] --> B[功能规格说明书<br/>客户视角的行为描述]
B --> C[技术规范<br/>复杂/可复用组件的工程方法]
B --> D[工作项目列表<br/>按天/半天粒度分解的程序设计任务]
C -.支撑.-> D
这张卡片看不懂?
这张卡片的反馈已满 10 条,暂时无法继续提交。
已有反馈 · 0 / 10 条
还没有人提交反馈。
在整书笔记中的位置
原书出处 · 1 处
- 第07章 撰写优秀的规格说明书 · 查看原书依据
内。这样,我们就有了基本的规格说明书,其中包括许多刚才描述过的多种规格说明书信息。 考虑这4种规格说明书的最简单方法,就是大致按时间顺序排序:需求、功能、技术和工作项目。如同很多任务一样,每种信息都是下一个的基础。团队越大、项目越复杂,可能就越需要正式区分这几种规格说明书。 谁负责规格说明书 在大型团队中
参考来源
- 位置:《项目管理之美》第7章《撰写优秀的规格说明书》"决定需要撰写什么"一节(源文件:_epub-src/OEBPS/Text/part0062.xhtml)
- 结论依据:原文依次定义需求、功能、技术规范、工作项目列表四种信息,并明确指出"考虑这4种规格说明书的最简单方法,就是大致按时间顺序排序:需求、功能、技术和工作项目。如同很多任务一样,每种信息都是下一个的基础",直接支撑本卡片结构。
- 原始内容:需求、功能、技术和工作项目