第3章 功能边界模糊排查

功能边界模糊是B端PRD中最隐蔽、破坏力最大的错误模式之一。它不像语法错误能被编译器捕获，也不像逻辑断点能被测试用例直接命中；它潜伏在需求描述的“附近区域”、跨系统交互的“灰色地带”以及未书面化的“默认理解”中。本章按现象识别 → 数据采集 → 原因定位 → 修复动作 → 复测 → 预防六步闭环，用故障树、排查表和判断规则帮你系统清除边界模糊。

3.1 现象识别

边界模糊不会直接报错，但它会通过一组可观测的“症状”表现出来。当你的PRD评审或开发过程中出现下表症状时，立即启动边界排查。

3.2 数据采集

确认症状后，立即采集以下三类数据，为原因定位提供证据链。每一类数据采集都对应一个具体的判断规则。

• 规则R1（需求原文快照）：将PRD中所有涉及跨系统、跨模块、跨角色的需求描述原文摘出，按“功能点→原文→模糊词标记”三列制表。模糊词标记包括：等、之类、根据实际情况、适当、其他、默认、自动。
• 规则R2（接口/协议定义对齐）：收集所有对外依赖的接口文档、API定义、枚举表、数据字典。将PRD中引用的字段名、类型、取值范围与源头文档逐字段比对，记录不一致项。
• 规则R3（边界场景清单）：列出所有“系统外部输入”和“系统外部输出”的边界点，包括：用户输入、第三方回调、定时任务触发、消息队列消费、文件导入导出。对每个边界点标记“是否定义了异常行为”。

// 需求原文快照示例（R1采集结果）
// PRD原文："用户提交工单后，系统自动分配审核人，分配规则根据部门、忙闲程度等因素综合计算"
// 模糊词标记：自动、根据……等因素
// 归属模块：工单管理
// 交叉影响：人员管理模块、组织架构模块

3.3 原因定位

将采集到的数据映射到故障树中。故障树将边界模糊拆解为三个主因分支，每个分支下再分两个典型子原因。排查时从根节点出发，沿可见症状向下追踪，直到命中子原因。

排查时配合下表进行交叉定位，将现象S01-S05与故障树节点建立映射，快速缩小范围。

3.4 修复动作

根据故障树定位到的叶子节点，执行对应的修复动作。每个修复动作必须输出一个可验证的边界定义工件。

• 修复F1（数据流向重叠）：绘制数据主权矩阵，横轴为“系统/模块”，纵轴为“数据实体”，在每个单元格中标记“C（创建）”“R（读取）”“U（更新）”“D（删除）”中的一项或多项，消除重叠。
• 修复F2（职责归属不清）：编写功能职责声明表，每个功能点对应唯一“负责模块”，并注明“依赖模块”和“接口协议版本”。
• 修复F3（需求无边界控制）：在需求描述中强制插入边界条件段，使用下方模板。
• 修复F4（隐性需求膨胀）：实施需求变更冻结期——当前版本所有新增需求必须经过“边界影响评估”才能进入PRD。
• 修复F5（异常场景遗漏）：为每个边界点补充异常行为表，包含：超时、重试、熔断、降级、拒绝服务、数据不一致、第三方不可用。
• 修复F6（输入输出未约束）：定义输入校验规则和输出承诺契约，明确格式、范围、非空、唯一性、精度等约束。

// 边界条件段模板（F3修复输出）
// 用于需求描述中“功能描述”之后、“验收标准”之前
//
// 【边界条件】
// 1. 输入边界：
//    - userId：必须为整数，范围 [1, 2^31-1]，非空
//    - attachment：可选，单文件，最大10MB，仅支持 pdf/docx/xlsx
// 2. 系统边界：
//    - 依赖：审批流引擎（v2.3+）——超时时间 5s，超时后走降级：自动转人工
//    - 依赖：通知中心（v1.8+）——异步投递，不阻塞主流程
// 3. 异常边界：
//    - 审批人不可用：跳过该节点，转管理员池
//    - 附件解析失败：记录错误日志，不影响工单提交
// 4. 数据边界：
//    - 工单状态机：DRAFT → SUBMITTED → APPROVED/REJECTED → CLOSED
//    - 不允许从 REJECTED 直接跳转到 APPROVED

3.5 复测

修复完成后，使用边界模糊复测检查表逐项验证。复测结果必须记录到PRD的评审纪要中，作为定稿依据。

3.6 预防

将边界模糊的预防能力内置到PRD编写流程中，建立三道防线。

• 防线1——边界条件前置模板：在PRD模板的“功能描述”之后、“验收标准”之前，强制插入【边界条件】章节。没有该章节的PRD不予评审。
• 防线2——边界变更影响评估：任何需求变更必须附带“边界影响分析”，说明变更影响了哪些系统边界、数据主权、异常路径。分析结果由架构师签字确认。
• 防线3——边界模糊门禁：在PRD评审流程中设置自动化门禁，使用关键词正则表达式 (等|之类|根据实际情况|适当|其他|默认|自动) 扫描全文，若命中数量 > 3，自动拒绝评审并通知编写人修改。

// 边界模糊门禁配置示例（集成到PRD评审工具中）
{
  "gateName": "边界模糊检测",
  "enabled": true,
  "action": "REJECT",
  "threshold": 3,
  "patterns": [
    "等", "之类", "根据实际情况",
    "适当", "其他", "默认", "自动"
  ],
  "excludeSections": ["术语表", "附录"],
  "notificationTargets": ["prd.author", "tech.lead"]
}