全面解析 | 如何做好输出「需求文档」这件「小事」？

2017-07-05 23:31:00

Anyway,「方法只是思维层级里底层的事情」。

最近一直在思考「输出需求文档」这件「小事」，发现太多产品经理连需求都没办法完全表达清楚，在需求评审会上支支吾吾，被各种挑战，或者开发阶段中多次重复确认，疲于各种沟通。相信每个产品新人都有过这种痛苦，解决的方法只有一种：「产品逻辑想得比任何人都多」。而需求文档是其中一种思维工具，利用好文档帮助自己梳理逻辑，掌握自己的节奏。

同时，需求文档能够在复杂需求流程中起到重要作用：
表达产品设计的需求，提高团队协作效率，是最重要的「协作工具」
作为可验收的「产品标准」

「输出需求文档」是每个新人很长一段时间都要做的事情，发现竟然大部分导师或者前辈都不会系统讲解的。「输出需求文档」是产品经理产品设计能力中最基本的基本功，就像UI同学用PS画图，开发哥敲代码一样，后两项技能/工具是需要花4年大学时间或者甚至更长的时间学习的，而大部分产品经理竟然都没有学习过需求文档这件事情，如果大学开产品经理专业，「输出需求文档」一定是大一就要学的课程。

我这里一直讲的是「输出需求文档」，不仅仅包括写需求文档这件事，「输出」应该是一个动作。可以看到需求的完整流程，「输出需求文档」应该分为需求前、需求中、需求后，写文档只是其中的一部分。

这次分享的是与需求文档相关的动作，需求跟进和管理又是另外一个大课题，这次框架里不包括。

一、写需求文档

推荐这种结构的需求文档，采用的是结构化导航模式（网上已经有很多模板了），这样的好处是清晰明了，开发、测试、设计不同角色可以根据自己需要看自己关注的部分，不用对着文字版需求说明书来回找。
再来，完整又简洁的需求文档应该包括：文档简介、需求分析、结构流程、原型交互、埋点说明。

沿用了这种模板和结构的不一定是好需求文档，更重要是每一部分里的思维和逻辑，模板和结构只是表面。

（1）文档说明

版本说明

让参与人员能第一眼清楚看到这次版本或者功能包括哪些部分，能大概有预期工作量。为了清楚描述需求概况应该包括：

1. 序号：有几个功能需求点。
2. 类型：将需求分为新增、修改、删除。
3. 功能点：功能名字。
4. 需求描述：简要描述功能点，理解功能概况。
5. 优先级：功能重要性，分为P0,P1,P2(当然也可以直接分为高中低，或其他写法)，不建议超过3个优先级，意义不大。P0定义为必须完成，P1定义为无意外的话需要完成，P2可做可不做。
6. 详情：我这里只是为了方便点击跳转到相应需求说明的位置。

修改历史

是的，很多情况下需求从开始，到结尾从来没有更新过。这样导致的问题会很严重，需求版本不同步，验收时错误或漏掉需求，反复修改。需求同步不是一件容易的事情，文档修改历史可以帮助需求同步。

1.详细描述文档改动点，包括时间、版本号、类型（增删改）、严谨的修改说明。以下是两类示例：

a. 不合格的修改说明：修改标签库逻辑
b. 严谨的修改说明：在评论提醒中
C回复B不需要通知A的，因为A不会非常在乎B与C讨论的内容
点击通知栏的时候如果没登录是调起登录的
小红点逻辑：启动的时候拉取
列表刷新：每次都进入都刷新
定位位置，点赞定位问题

特别多人讨论确定逻辑后需要修改在文档里，详细描述。

2. 同步给所有参与人（这部分目前我是通过公司的协助工具上传文件，这样能够邮件通知，暂时还没有更好的工具）

（2）词汇说明

并不是项目组每个人都明白产品经理在需求分析、交互原型里说的名词，将名词解释明白即可。

（3）需求分析

需求文档里的需求分析，目的很简单，是说服项目组认可这个功能或需求，能将需求安排下去，常用的方式两种方式：

逻辑型说服：阐述明白需求是如何产生的，价值是什么，为了达到产品最终目标，这个需求是什么的作用。在我另外一篇文章里已经详细描述，并且详细举例说明，这里不再赘述。请看《如何从分析到需求全过程 | 全民K歌“你点TA唱”实例讲解》
数据型说服：通过估算这个需求带来的直接数据增长，比如用户数、收入、点击率等等

（4）原型交互

「最容易理解的需求方式是界面长得怎么样」，别让项目组其他同学对着文字版需求理解。原型交互式整个需求文档中最重要的部分，也是最需要详细描述的部分，包括客户端逻辑、服务端逻辑、交互逻辑、边缘场景（并不是每个需求都有客户端逻辑或服务端逻辑）。

客户端逻辑

描述客户端界面元素的展示和操作逻辑，推荐图文结合的方式。

1. 界面原型：可以用各种原型工具完成，积累自己的素材库能更快的完成高保真原型。（示意图用的是sketch）
2. 入口：说明功能触发的入口，哪里触发是理解的第一步
3. 展示元素：描述界面需要的每个元素和展示逻辑
4. 行为交互：分为加载和点击，数据/界面是如何加载出来，点击后会有什么效果

服务端逻辑

服务端部分指为用户提供产品服务时涉及的数据逻辑等等，完整梳理应该包括后台功能和服务端数据逻辑。
1.后台功能：指后台配置功能部分，目的是给运营同学配置内容。一般包括后台前端，配置项、增删改功能，可以根据功能难易是否需要后台原型。

（简单版）

（可交互后台原型）

2.服务端数据逻辑：定义数据结构和数据下发逻辑，以热文库这个功能为例子解释下。

功能背景：通过挑选热点内容，覆盖头部内容，提高内容质量和点击率

数据定义
热文：分别与内容库(XX库、XXX库)内容匹配，匹配度2.0以上,TOP1匹配度作为热文
热文库：每天XX:00点、XX:00点、XX:00点更新和重新匹配，将文章入库，这些文章集合为热文库
数据下发逻辑
目标：用户刷新时，将热文按XX顺序下发到XX位置
其他逻辑…

交互逻辑

指的是界面和元素之间的交互行为。即使公司里有专职的交互设计师，产品经理也不应该省略这一部，只有完整考虑流程和细节，才能和设计师、项目组任何成员流畅讨论。

与客户端逻辑不同的是，这部分更多是界面之间操作流程，辅助界面的交互说明（点击、加载、动画），几个注意点：

交互设计的本质是「让用户更快更便捷的使用服务或产品内容」
始终考虑交互设计五个要素，媒介、场景、行为、目的、用户

边缘场景

如果你完成了上面的主要逻辑场景，一般来说功能只完成了一半，甚至没有。边缘场景的梳理这部分是最容易遗漏的地方，一旦遗漏就会陷入各种沟通和反复中。总结了常见的边缘场景，写完原型说明必检查。

网络状况：移动、WIFI、断网、弱网
最大限制：字符、数据、等待时长等等
缺省状态（为零）：输入/展示为零
多场景：夜间、横屏、竖屏、不同渠道等等
账号状态：未登录/已登陆、多设备登陆、状态切换不同步
服务器异常处理

（5）结构流程

信息架构

当信息项特别多而复杂的时候有必要将信息架构列出来，按照界面、界面元素、信息项逐项拆解，目的是在测试同学在写用例时更方便查找。

业务流程

业务流程在技术同学开发时关注的部分，分为数据流程和用户流程两类流程。

1. 数据流程：数据交互逻辑，描述前端、客户端、服务端数据情况。

2. 用户流程：用户交互流程，描述用户操作流程。

（6）埋点说明

埋点的作用是为了功能上线后做分析调整，也是迭代的关键辅助，一定要做到「有功能必埋点」。埋点包括三个部分：事件ID、事件名称、统计口径、事件描述。

事件ID 事件唯一标识，一般使用英文表述意义，单词间使用下划线隔开，如  click_add_bookmark_folder
事件名称：事件的中文名称。
统计口径  指埋点类型，分别为计数事件、内容计数事件、计时事件、状态事件。

计数事件:只计算次数的事件类型
内容计数事件:除了计算次数，还有其他参数上传，参数一般用英文区分，如 from=下载来源，package=下载包名， host=下载链接 host，此类型多用于减少计数事件埋点和用于报表生成。
计时事件:用于计算用户使用事件，多用于页面停留计算，进入页面开启计时器，离开页面时停止计时器，并生成事件
状态事件:用于上报开关状态情况，通常用 0,1 表述。

4. 事件描述：什么时候触发埋点

需要关键点是：