评审模板结构设计:核心字段与填写规范
章节定位:本章定义《优先级评审模板》的四个核心字段——议题、优先级等级、决策依据、风险等级,并给出每条字段的填写规范与检查清单。学员完成本章后,能独立创建符合组织标准的评审模板,并确保每次填写内容具备可追溯、可量化的结构。
适用场景
- 需要统一跨团队(产品、研发、测试、运维、安全)的变更/需求/缺陷评审格式。
- 每月/每迭代的优先级评审会,或紧急变更的快速评审。
- 审计或合规要求留存决策记录,且记录必须包含标准化字段。
- 新建评审流程时,模板设计阶段。
前置条件
- 确认评审范围(如:线上故障修复、新功能上线、技术债务治理)。
- 组织已定义 优先级等级表(P0/P1/P2/P3)和 风险等级定义(高/中/低)。
- 已指定评审委员会角色(至少包括决策人、记录人)。
- 准备共享文档平台(Wiki、Confluence、石绵文档等),模板文件格式为 .md 或 .drawio。
操作步骤与填写规范
| 步骤 | 动作 | 责任人 | 产出物 |
|---|---|---|---|
| 1 | 创建/复制模板文件 | 记录人 | 空白模板文档 |
| 2 | 填写 议题 字段 | 提交人 | 精准议题描述 |
| 3 | 按定义表选择 优先级等级 | 提交人 + 决策人 | 等级标记 |
| 4 | 填写 决策依据 字段 | 决策人 | 书面化理由 |
| 5 | 评估并填写 风险等级 | 技术负责人 | 风险标签 + 说明 |
| 6 | 交叉检查字段规范性 | 记录人 | 合规性检查 |
字段填写规范细则
| 字段名称 | 定义 | 规范要求 | 反例 |
|---|---|---|---|
| 议题 | 待评审的事项名称+一句话摘要 | 格式:[类型] 对象 — 目标。例如:[故障] 支付网关超时 — 恢复成功率至99.9%。 | “修复支付问题” |
| 优先级等级 | 按组织预定义等级表选择 | 只能从等级表单选:P0(立即)、P1(今日)、P2(本周)、P3(本月)。禁止自定义文字。 | “紧急”“高优”“urgent” |
| 决策依据 | 做出该优先级判断的具体理由 | 必须包含: ① 关联的业务指标(用户量/收入/合规) ② 是否阻断后续工作 ③ 参考数据或来源 |
“因为很关键” |
| 风险等级 | 执行该变更或决策可能带来的整体风险 | 高:影响核心数据/资金/可用性;中:影响非核心功能;低:无影响或可回退。 备注:必须附风险描述。 |
只写“高”而无任何解释 |
填写示例(合规):
议题:[变更] 数据库连接池扩容 — 将max_connections从200提升至500
优先级等级:P1
决策依据:当前连接池使用率达到95%,已有10%用户出现502错误,影响核心订单流程。据SLA约定,此场景必须在2小时内恢复。
风险等级:中 — 扩容期间可能出现短暂连接中断,已准备回退脚本。
常见错误:
- 议题与风险等级混写(如把风险描述写到议题中)。
- 决策依据只写“按惯例”或“领导要求”,缺少可量化理由。
- 优先级等级使用“普通/重要/特急”等非标准词汇。
输入输出物
| 类型 | 名称 | 格式 / 说明 |
|---|---|---|
| 输入 | 原始变更/需求/缺陷清单 | Jira Issue / 故障工单 / 需求文档 |
| 输入 | 组织优先级等级定义表 | .md 或 wiki 页面 |
| 输出 | 已填写的评审模板 | 每项一行,每个字段完整 |
| 输出 | 字段合规性检查表 | 每行对应字段,标记通过/不通过 |
责任边界
- 提交人:负责填写议题和建议优先级等级,对议题描述的准确性负责。
- 决策人:最终确认优先级等级,并撰写决策依据;若驳回需记录原因。
- 技术负责人:评估风险等级并填写详细风险描述。
- 记录人:检查所有字段格式规范,确保无遗漏;归档模板与决策记录。
记录材料
- 完成的评审模板(每个议题一条记录)。
- 决策记录日志(包含模板字段的快照,不可事后篡改)。
- 合规性检查表(记录人签字+日期)。
异常处理
| 异常情景 | 处理方式 |
|---|---|
| 议题信息不足(缺少指标或对象) | 标记为“退回补充”,并通知提交人在4小时内补充。 |
| 决策依据字段为空或过于模糊 | 决策人需当场补充,否则该议题不进入评审结果。 |
| 风险等级与描述矛盾(如“低风险”却描述为影响资金) | 要求技术负责人重新评估并更新记录;不一致的议题需重新复核。 |
| 优先级等级使用非标准标签 | 记录人直接按等级表映射并打回给提交人修改;严重违规时计入评审质量指标。 |
验收标准
- 每个议题的四个字段均填写且符合规范细则。
- 决策依据字段包含至少两项量化信息(指标/阻断/来源)。
- 风险等级字段附带独立的风险描述(不少于30字)。
- 无自定义优先级标签,全部采用组织等级表。
- 检查记录已由记录人签字确认。
验收快速检查表:
□ 议题格式 = [类型] 对象 — 目标
□ 优先级等级 = {P0|P1|P2|P3}
□ 决策依据 ≥ 2 条量化理由
□ 风险等级 = {高|中|低} + 描述
□ 无空字段、无模糊用语