需求文档检查清单模板:PRD与需求规格说明书检查项及判定标准
需求文档评审最容易出现两种结果:会上提了不少意见,却说不清哪些必须改;或者逐条看过,仍无法判断需求能不能进入开发。这份检查清单模板把PRD和需求规格说明书的检查项分成要素完整性、结构一致性、描述可读性三类,每项都给出可观察的通过条件、证据位置和结论口径,并标注阻断项。评审人按表逐项核对,就能形成可复核的结论。
Table of Contents
要点总览(TL;DR)
- 这份清单按要素完整性、结构一致性、描述可读性三类组织,PRD侧重业务背景、目标用户、功能范围、主流程与验收口径,需求规格说明书侧重功能编号、输入输出、业务规则、异常分支与非功能约束。
- 判定标准统一写成三要素:可观察的通过条件、证据位置、结论取值(通过/不通过/待补),让不同评审人对同一检查项给出一致结论。
- 阻断项与建议项分开:核心要素缺失、编号冲突、PRD与规格书条目对不上、需求不可验证列为阻断;术语统一、图表细节等列为建议项。
- 检查完成的标志是阻断项清零、待补项有责任人和期限、评审结论已记录可查询;待补项到期未关闭的升级为阻断项处理。
- 清单只覆盖需求文档内容本身,文档协同权限与AI生成内容另行处理;团队可用ONES Wiki页面模板库固化清单格式,用页面组关联项目核对条目一致性。
谁在什么时点用这份检查清单
这份清单面向参与需求评审的几类角色:产品经理或需求分析人员负责自查,评审人负责复核,开发和测试代表从实现与验证角度确认需求是否可落地。不同角色关注点不同,但使用同一份检查项和判定口径,结论才能对齐。
使用时点有三个。PRD初稿完成后,产品经理先自查要素是否齐全;需求规格说明书定稿前,评审组做完整核对,重点看结构一致性和可验证性;需求变更评审时,用清单检查变更涉及的条目是否同步更新了编号、规则和验收条件。三个时点的检查深度不同,初稿阶段可以容忍待补项,定稿前阻断项必须清零。
两类文档的检查侧重需要分开。PRD回答“为什么做、给谁做、做到什么程度”,检查重点是业务背景、目标用户、功能范围与优先级、主流程和验收口径。需求规格说明书回答“具体怎么做、边界在哪里”,检查重点是功能编号、输入输出、业务规则、异常分支和非功能约束。用同一套条目检查两类文档,容易在PRD里追问字段格式,在规格书里反复讨论业务价值,评审效率反而下降。
清单只覆盖文档内容本身。文档的协同权限配置、评审流程设置、AI辅助生成内容等事项不在检查范围内,需要另行处理。
| 角色 | 使用时点 | 检查范围 |
|---|---|---|
| 产品经理/需求分析人员 | PRD初稿完成、规格书提交评审前 | 要素完整性自查,补齐明显缺项 |
| 评审人(产品、技术负责人) | 规格书定稿前 | 三类检查项全量核对,判定阻断项 |
| 开发代表 | 定稿前评审会 | 流程、规则、异常分支是否可实现 |
| 测试代表 | 定稿前评审会 | 验收口径是否可验证,能否据此设计用例 |
| 变更相关方 | 需求变更评审时 | 变更条目的编号、规则、验收条件是否同步更新 |
要素完整性检查项:PRD与需求规格说明书各查什么
要素完整性检查回答一个问题:这份文档该有的内容是否都在。缺要素的文档即使写得通顺,也无法支撑开发和验收。下表按文档类型列出必查要素,并标注是否阻断。
| 检查项 | 适用文档 | 检查内容 | 是否阻断 |
|---|---|---|---|
| 业务背景与问题 | PRD | 说明需求来源、要解决的业务问题、不做的后果 | 是 |
| 目标用户与场景 | PRD | 明确使用者角色、使用场景和触发条件 | 是 |
| 功能范围与优先级 | PRD | 列出本期范围、明确不做的内容、标注优先级 | 是 |
| 主流程 | PRD | 核心业务路径可从头走到尾,步骤完整 | 是 |
| 验收口径 | PRD | 每个功能点有可判断的验收条件 | 是 |
| 依赖与约束 | PRD | 外部系统依赖、时间约束、合规要求有交代 | 否 |
| 功能编号与层级 | 需求规格说明书 | 每个功能点有唯一编号,父子层级清晰 | 是 |
| 输入输出与字段 | 需求规格说明书 | 关键操作的输入项、输出结果、字段类型与必填规则明确 | 是 |
| 业务规则 | 需求规格说明书 | 计算规则、状态流转、权限规则可判断 | 是 |
| 异常与边界分支 | 需求规格说明书 | 失败、超时、并发、空数据等场景有处理说明 | 是 |
| 非功能约束 | 需求规格说明书 | 性能指标、兼容范围、安全要求有量化或明确范围 | 否 |
要素缺失的处理方式按阻断标记区分。阻断项缺失时,文档退回补充,不进入下一环节;非阻断项缺失时,记录为待补项,指定责任人和补充期限,可以带条件通过。例如非功能约束未写全,但本期功能不涉及高并发场景,可先记录待补,在开发启动前补齐。
结构一致性检查项:编号、层级与追溯关系
结构一致性检查文档内部是否自洽、能否与上下游对齐。这类问题在长文档和多轮修改后最常见,也最容易在开发阶段暴露。
| 检查项 | 通过标准 | 证据位置 |
|---|---|---|
| 功能编号唯一性 | 全文无重复编号,新增条目按规则续编 | 规格书功能清单章节 |
| 层级关系 | 父子功能归属明确,同一功能不出现在两个父级下 | 功能清单与目录 |
| PRD与规格书对应 | PRD列出的功能在规格书中均有条目,规格书无PRD范围外的多余功能 | 两份文档的功能清单对照 |
| 需求到验收的追溯 | 每个功能条目能对应到验收条件或测试用例 | 验收条件章节、用例编号 |
| 术语与版本一致 | 同一概念全文用词统一,版本号与变更记录匹配 | 术语表、文档头、变更记录 |
| 图表与正文一致 | 流程图、状态图的节点和分支与文字描述一致 | 流程图及其对应段落 |
编号冲突和PRD与规格书条目对不上,通常列为阻断项,因为后续开发排期和用例设计都依赖这套编号。术语不统一、图表与正文有细微出入,可以先记为建议项,在定稿前统一修订。
描述可读性检查项:让开发和测试能读懂
描述可读性检查需求是否具体、无歧义、可验证。判断方法很简单:开发和测试读完这一条,能否给出相同的理解和相同的验证方式。
| 检查项 | 反例 | 改写要求 |
|---|---|---|
| 完整句子描述 | “优化列表页体验” | 写明优化哪个操作、达到什么结果 |
| 避免模糊词 | “尽快返回”“界面友好”“适当提示” | 替换为具体时限、具体表现或判断条件 |
| 规则可判断 | “根据情况决定是否审批” | 写出触发条件与对应结果,形成条件—动作结构 |
| 异常与边界明确 | 只描述正常流程 | 补充失败、超时、空值、并发等场景的处理 |
| 用词统一 | 同一对象在不同章节叫“订单”“工单”“单据” | 确定标准术语,全文替换 |
| 长流程结构化 | 一段文字堆叠十几个步骤 | 改为步骤列表或配流程图,每步一个动作 |
可读性问题大多列为建议项,但有一类例外:需求描述无法验证时,测试无法设计用例,应升级为阻断项。例如验收条件写成“系统运行稳定”,没有可观察的指标,就属于不可验证。
判定标准怎么写:通过条件、证据与结论口径
判定标准的作用是让不同评审人对同一检查项给出一致结论。写法统一为三要素:可观察的通过条件、证据位置、结论取值。结论只取三种:通过、不通过、待补。
| 检查项 | 通过条件 | 证据 | 结论口径 |
|---|---|---|---|
| 功能编号唯一 | 全文检索无重复编号,新增条目按规则续编 | 规格书功能清单 | 有重复即不通过;编号规则未定义记待补 |
| 验收口径可验证 | 每个功能点有可观察的验收条件,测试能据此写出用例 | PRD验收章节、用例草案 | 存在无法验证的条目即不通过 |
| 异常分支完整 | 关键操作的失败、超时、空数据场景均有处理说明 | 规格书异常分支章节 | 核心流程缺异常说明不通过;次要场景缺失记待补 |
| 术语统一 | 同一概念全文用词一致 | 全文检索结果 | 存在混用记待补,定稿前修订 |
阻断项与建议项的判定口径要分开。阻断项只有“通过”和“不通过”两种结论,不通过即退回;建议项允许“待补”,但必须写明补什么、谁补、何时补。评审前应约定哪些条目属于阻断项,避免会上临时争论。
判定结论的记录格式建议包含:检查项编号、结论、证据位置、问题描述、责任人、期限。复核时按记录逐条确认,待补项关闭后更新结论,形成可追溯的评审记录。
证据、负责人与阻断项:清单怎么落地
清单能否发挥作用,取决于每项检查是否有明确证据、明确负责人和明确的阻断规则。证据指能直接指向问题位置的文档章节、功能编号、截图或评审记录,写“文档不完整”无法支撑结论,写“规格书3.2节缺少超时处理说明”才能被复核。
负责人分工按角色划分:产品经理完成自查并对要素完整性负责;评审人复核结构一致性和描述可读性;测试代表确认验收条件可验证;开发代表确认规则与异常分支可实现。每项检查在表中标注负责人,避免出现“大家都看过、没人负责”的情况。
阻断项清单建议固定为以下几类:核心要素缺失(业务背景、功能范围、验收口径、功能编号、业务规则、异常分支)、编号冲突或PRD与规格书条目对不上、需求不可验证。这些问题的共同点是会直接导致开发返工或测试无法开展。表述风格、术语统一、图表细节等列为建议项,不阻断评审通过。
完成条件写清楚:阻断项清零;待补项均有责任人和期限;评审结论已记录并可查询。满足这三条,本次检查才算完成。后续跟踪以待补项清单为入口,到期未关闭的升级为阻断项处理。
在评审落地环节,如果团队使用ONES,可以用ONES Wiki的页面模板库固化这份清单的表格格式,让每次评审从同一模板创建记录;页面组关联项目后,需求文档与项目条目互相对应,便于核对PRD与规格书的条目一致性;页面版本记录支持查看和回滚,变更评审时可对照历史版本确认修改范围。这些能力承载的是清单的执行与留痕,检查项和判定口径仍需团队按本文模板自行约定。
常见问题
PRD初稿阶段就要按阻断项标准检查吗?
不需要。初稿阶段以要素完整性自查为主,允许存在待补项,产品经理先把业务背景、目标用户、功能范围、主流程、验收口径这些核心要素补齐。阻断项清零的要求放在需求规格说明书定稿前,因为此时文档要进入开发和测试排期。变更评审时再按变更范围核对编号、规则和验收条件是否同步更新。三个时点用同一份检查项,但判定严格程度不同。
需求描述无法验证时,为什么按阻断项处理?
可读性问题大多列为建议项,但验收条件写成“系统运行稳定”“体验流畅”这类没有可观察指标的表述时,测试无法据此设计用例,开发也无法确认做到什么程度算完成。这类问题会直接卡住后续环节,所以升级为阻断项。处理方式是要求补充可观察的指标或判断条件,例如响应时间上限、操作成功后的页面状态、数据一致性校验方式。
PRD和需求规格说明书由不同人维护,条目对不上怎么办?
先在结构一致性检查中把“PRD功能范围与规格书条目一一对应”列为必查项,评审前由评审人对照两份文档的功能清单逐条核对,标出遗漏和多余条目。如果团队使用ONES Wiki,可以用页面组关联项目,让需求文档与项目条目互相对应,减少人工对照的遗漏。对不上的条目在评审记录中写明具体编号和差异,指定责任人补齐或删除,关闭后再复核。
待补项到期没关闭,怎么处理?
完成条件里已经写明待补项必须有责任人和期限,到期未关闭的升级为阻断项处理,文档退回补充,不进入下一环节。跟踪以待补项清单为入口,每次复核时更新结论。这样处理可以避免待补项长期挂着、评审结论形同虚设。团队需要在评审前约定升级规则和判定人,减少临时争论。
清单条目要不要和团队已有的文档模板对齐?
需要。检查项如果和团队固定的章节模板、编号规则错位,评审人会在文档里找不到对应证据位置,判定标准也就落不了地。建议先梳理现有PRD和规格书的章节结构,把清单条目映射到具体章节,再约定哪些条目属于阻断项、谁有权判定阻断。模板格式可以用ONES Wiki的页面模板库固化,让每次评审从同一模板创建记录,检查项与文档结构保持一致。



