要看,而且这两项适合作为SRS模板评估的第一层门槛。章节完整性决定模板能否承载需求来源、范围、功能、非功能、接口、约束、验收与变更等信息;需求可测试性决定按模板写出的条目能否被验证。本文给出一套可复算的评估口径:先核对必备章节覆盖,再逐条判定需求可测试性,随后检查追溯字段、变更记录与评审可用性,最后形成通过、有条件通过或不通过的结论。
要点总览(TL;DR)
- 要看。章节完整性决定模板能否承载必要信息,需求可测试性决定写出的条目能否被验证,两项适合作为SRS模板评估的第一层门槛。
- 章节完整性按必备章节覆盖率计算:已覆盖必备章节数÷评估清单必备章节总数;需求可测试性按可验证条目占比计算:可验证条目数÷被检查条目总数。
- 评估顺序为:核对必备章节→逐条判定需求可测试性→检查追溯字段与变更记录→检查评审可用性→汇总评分并给出通过、有条件通过或不通过结论。
- 达标线由组织结合项目类型约定,评估表中记录约定值;分母为零时该项记为不适用,不强行给分。
- 章节齐全不等于内容正确,可测试性比例高不等于需求质量高,评估结果应作为模板改进输入,并随模板修订节奏复评。
评估目标:模板要过哪几道关
评估对象是SRS模板本身,不是某个项目的具体需求文档。判断的问题是:用这份模板写需求,能否稳定产出信息完整、条目可验证、后续可追溯和可评审的规格说明。单个项目文档写得差,可能出在填写执行;模板缺少必要章节或缺少可测试性约束,则会在多个项目重复出现同类问题。
评估结论分为三档:通过,表示五项检查点均达到组织约定要求;有条件通过,表示主要检查点基本满足,但存在明确缺口并附整改条件与复评时间;不通过,表示章节完整性或需求可测试性存在结构性缺失,需要先修订模板再投入使用。
五项检查点按先后关系组织:章节完整性是入口检查,模板连必要信息位置都没有,后续检查无从谈起;需求可测试性检查模板是否引导写出可验证条目;追溯字段与变更记录检查模板是否留下关联和演化线索;评审可用性检查评审人能否在模板中找到判断所需信息。前两项决定能否进入下一轮,后三项决定模板能否在项目中稳定运行。
指标与范围:五项检查点怎么定义
五项指标分别回答不同问题,计算口径需要事先固定,避免评估人各自理解。下表给出定义、分子分母与单位,其中必备章节清单和可测试性判定规则由组织在评估前确定,本文不预设统一达标线。
| 检查点 | 定义 | 分子 | 分母 | 单位与表达 |
|---|---|---|---|---|
| 章节完整性 | 模板对评估清单中必备章节的覆盖程度 | 模板中已覆盖的必备章节数 | 评估清单确定的必备章节总数 | 百分比,必备章节覆盖率 |
| 需求可测试性 | 按模板写出的需求条目中可被验证的比例 | 判定为可验证的需求条目数 | 被检查的需求条目总数 | 百分比,可测试条目占比 |
| 追溯字段 | 模板是否提供需求来源、关联工作项、验收依据等追溯字段并引导填写 | 已具备且可填写的追溯字段数 | 评估清单确定的追溯字段数 | 百分比,字段齐备率 |
| 变更记录 | 模板是否要求记录需求变更的原因、影响范围与确认人 | 具备变更记录要求并实际留痕的条目数或文档数 | 发生变更的条目数或文档数 | 百分比,变更记录完整率 |
| 评审可用性 | 评审所需信息能否在模板中直接定位 | 评审所需信息项中可定位的项数 | 评审所需信息项总数 | 百分比,信息齐备率;辅以缺失项清单 |
章节完整性按必备章节覆盖率计算,必备章节清单应覆盖需求来源与背景、范围与边界、功能需求、非功能需求、接口与数据、约束与假设、验收依据、变更与待决问题等类别。需求可测试性按可验证条目占比计算,判定一条需求是否可验证,看它是否包含明确对象、可观测行为与可判定的预期结果;只写“系统应友好”“性能良好”这类表述的条目计为不可验证。
追溯字段与变更记录按字段存在与填写情况检查,分两层:模板是否设置了字段,以及按模板产出的文档是否实际填写。评审可用性按评审所需信息是否齐备判断,检查范围、背景、验收依据、待决问题能否在固定位置找到,避免评审人靠口头补充理解需求。
数据口径:抽样、计数与缺失值处理
评估取数先确定文档范围与时间窗。抽样范围建议选取最近一个完整迭代或近三个月内使用该模板产出的SRS文档,样本量按组织可投入的评估人力确定,至少覆盖两个不同项目或团队,以减少单一项目写作习惯带来的偏差。样本确定后不再临时替换,替换需记录原因。
计数单位统一为需求条目。章节完整性以模板为对象核对一次;需求可测试性、追溯字段与变更记录以条目为单位统计;评审可用性可按文档检查,也可按评审所需信息项逐项核对。同一需求拆分或合并时,以评估时点的条目编号为准,避免重复计数。
缺失值处理规则如下:模板缺少某个必备章节,该章节计入分母并记为未覆盖;字段存在但文档中为空,按未填写处理,不计入已填写;条目表述模糊无法判断是否可验证时,由两名评估人独立判定,不一致的条目提交第三人裁定并记录理由。分母为零时,该项记为不适用,不强行给分,也不以其他项得分替代。例如样本期内没有发生需求变更,变更记录完整率记为不适用,并在结论中说明原因。
评估步骤:从章节核对到可测试性判定
评估按固定顺序执行,前一步的产出作为后一步的输入,避免边看条目边改标准。
第一步,核对必备章节。以组织确定的必备章节清单逐项对照模板,标记已覆盖、部分覆盖和缺失。部分覆盖指章节存在但缺少关键子项,例如有“非功能需求”章节但未区分性能、安全、可用性等类别,此类按未完全覆盖记录,并在备注中写明缺口。
第二步,逐条判定需求可测试性。从样本文档中抽取需求条目,按统一规则判定:条目是否指明对象,是否描述可观测的行为或输出,是否给出可判定的预期结果或验收条件。三项均满足计为可验证;缺少任一项计为不可验证,并记录缺失类型,便于后续修订模板时增加填写提示或示例。
第三步,检查追溯字段与变更记录。核对模板是否设置来源、关联工作项、验收依据等字段,再抽查文档中这些字段的填写情况。变更记录检查关注变更原因、影响范围和确认人是否留痕,未发生变更的条目不计入分母。
第四步,检查评审可用性。模拟一次评审,列出评审人判断需求是否可接受所需的信息项,逐项确认能否在模板固定位置找到。找不到的信息项形成缺失清单,作为模板修订输入。
第五步,汇总评分与结论。将五项结果汇总为一张评估表,先看章节完整性与需求可测试性是否达到组织约定门槛,再看后三项是否存在系统性缺口。结论写明通过、有条件通过或不通过,附主要缺口、整改责任人与复评时间。达标线由组织结合项目类型约定,评估表中记录约定值,便于后续复评对比。
评估完成后,模板的日常落地还涉及模板版本管理和需求条目与文档的对应。ONES Wiki 提供页面模板库,可一键创建制式化文档模板,页面组可关联项目,使需求与文档互相对应;文档记录页面版本并支持查看与回滚,便于在模板修订后保留历史版本。对于需要跨角色协作的评估结论和整改项,可将模板、评估记录与需求条目放在同一协作空间中管理,减少评估标准与执行文档脱节。具体字段配置和版本功能以实际开通情况为准。
算例:一份模板的评估结果怎么得出
以下为演示情景,用于说明计算过程,数值不代表任何组织的实际评估结果。
假设评估清单确定必备章节为10项,某SRS模板覆盖8项,其中1项为部分覆盖,按未完全覆盖计。章节完整性=8÷10=80%。缺失的两项分别为“接口与数据定义”和“待决问题跟踪”。
从两个项目抽取需求条目共50条,逐条判定后,32条包含明确对象、可观测行为和可判定预期结果,计为可验证。需求可测试性=32÷50=64%。不可验证的18条中,10条缺少预期结果,5条只写定性描述,3条对象不明确。
追溯字段清单确定为4项,模板设置3项,字段齐备率=3÷4=75%;抽查50条中实际填写追溯字段的有30条,按条目计的填写率为60%。样本期内发生变更的条目为12条,其中8条记录了变更原因、影响范围和确认人,变更记录完整率=8÷12≈66.7%。
评审所需信息项共6项,可在模板中定位4项,评审可用性=4÷6≈66.7%,缺失项为验收依据和待决问题状态。
| 检查点 | 计算 | 结果 | 主要缺口 |
|---|---|---|---|
| 章节完整性 | 8÷10 | 80% | 接口与数据定义、待决问题跟踪 |
| 需求可测试性 | 32÷50 | 64% | 预期结果缺失、定性描述过多 |
| 追溯字段 | 3÷4;填写30÷50 | 75%;60% | 字段设置不全、填写率偏低 |
| 变更记录 | 8÷12 | 约66.7% | 部分变更未记录影响范围 |
| 评审可用性 | 4÷6 | 约66.7% | 验收依据、待决问题状态不可定位 |
若组织约定章节完整性与需求可测试性均需达到80%方可进入下一轮,该模板两项均未达到,结论为不通过,优先补齐缺失章节并在模板中增加预期结果填写项与示例。若组织约定可测试性门槛为60%,则该项达到要求,但章节完整性仍不足,可给出有条件通过,条件是补齐两个缺失章节并复评。结论必须同时写明约定门槛,脱离门槛谈百分比没有判断意义。
解读与限制:指标能说明什么、不能说明什么
章节完整性高,说明模板为必要信息预留了位置,不能说明填写内容正确。模板有“非功能需求”章节,不等于每个项目都写清了性能指标和验证方法。需求可测试性比例高,说明条目更容易被验证,不能直接等同于需求质量高;一条需求可以写得可测试但业务价值低,也可能遗漏关键场景。评估结果应作为模板改进的输入,不能单独作为团队绩效结论。
不同项目类型对模板的要求存在差异。嵌入式或涉及外部接口的项目对接口、约束和追溯字段要求更细;内部工具类项目可能更关注范围与验收依据。评估时应按项目类型分别设定必备章节清单和门槛,跨类型直接比较百分比容易失真。样本量较小时,比例波动大,宜结合缺失项清单一起解读,避免只看一个数字。
复评周期建议与模板修订节奏绑定:模板发生结构性调整后应重新评估章节完整性和评审可用性;连续两个评估周期需求可测试性无明显改善时,检查问题出在模板提示不足还是填写执行不到位。调整触发条件可包括新增项目类型、监管或客户对追溯提出新要求、评审中反复出现同类信息缺失。每次复评沿用同一口径并记录门槛变化,保证结果可比。
常见问题
如果组织还没有确定必备章节清单和可测试性判定规则,能先开始评估吗?
可以先做一次基线盘点,但结论宜标注为“口径待定”。具体做法是:先按行业常见类别(来源与背景、范围、功能、非功能、接口与数据、约束、验收依据、变更与待决问题)列一版清单,再召集需求、开发、测试三方确认哪些是当前项目类型必须的,形成组织约定值。可测试性判定规则同样需要事先统一,至少明确“明确对象、可观测行为、可判定预期结果”三项是否同时满足才算可验证。口径确定后,之前盘点的数据可按新口径重算,避免不同评估人各自理解导致结果不可比。
样本期内没有发生需求变更,变更记录完整率怎么处理?
分母为零时,该项记为不适用,不强行给分,也不以其他项得分替代。评估表中注明“样本期内无变更”,结论部分说明该项未参与本次判定。如果组织希望评估模板对变更记录的引导能力,可以改为检查模板是否设置了变更原因、影响范围和确认人字段,按字段存在与否给出定性结论,但仍不计算百分比。复评时若出现变更条目,再按实际留痕情况计算完整率。
章节完整性和需求可测试性都达标了,是否可以直接判定模板通过?
不能直接判定通过。这两项是第一层门槛,达到约定线只说明模板具备承载必要信息和引导可验证条目的基础。还需检查追溯字段是否设置并引导填写、变更记录是否要求留痕、评审所需信息能否在固定位置定位。后三项若存在系统性缺口,例如追溯字段缺失导致需求来源无法关联,仍应给出有条件通过并附整改条件。结论应同时写明五项结果和约定门槛,避免只看前两项就下结论。
评估发现可测试性比例偏低,应该改模板还是改填写执行?
先看不可验证条目的缺失类型分布。如果多数条目缺少预期结果或验收条件,且模板中没有对应填写项或示例,问题更可能在模板引导不足,应优先在模板中增加预期结果字段、填写提示和正反示例。如果模板已设置字段但文档中普遍留空或写定性描述,问题更可能在填写执行,需要通过评审检查、填写培训或条目准入规则来改善。两类原因可能同时存在,评估记录中按缺失类型分别计数,便于定位主要矛盾后再决定修订动作。
不同项目类型用同一套门槛评估,结果可比吗?
可比性有限。嵌入式或涉及外部接口的项目对接口定义、约束和追溯字段要求更细,内部工具类项目可能更关注范围与验收依据。用同一套必备章节清单和同一达标线跨类型比较,容易把项目类型差异误判为模板质量差异。建议按项目类型分别设定必备章节清单和门槛,评估表中记录适用类型与约定值;跨类型汇总时只做趋势参考,不直接比较百分比高低。模板发生结构性调整或新增项目类型时,应重新校准门槛并记录变化。


















