需求缺口分析:发现规则缺口、异常路径与未定义状态
一份需求文档写完了,并不意味着需求已经足够完整。真正进入开发和测试之后,经常会发现一些之前没有被明确的问题:某个业务规则只描述了正常流程,异常情况没有定义;接口字段有了,但取值范围和校验规则没有说明;不同文档都提到了同一个功能,规则却对不上;甚至一些关键条件,只存在于聊天记录或团队成员的经验里。
这些问题单独看可能只是一个待确认项,但积累起来,就会变成开发阶段的反复沟通、测试阶段的场景遗漏,以及上线前才暴露出来的需求返工。
需求缺口分析(Requirement Gap Analysis)Skill 希望把这部分工作尽可能提前。它让 AI 结合需求文档、接口定义、业务规则、历史问题以及其他上下文材料,对需求进行交叉分析,系统识别缺失信息、模糊描述、逻辑冲突、边界遗漏、异常流程缺失、不可验证规则以及跨文档不一致等问题。
它并不是让 AI 替团队补写需求,而是帮助测试人员更快找到哪些地方还没有定义、哪些规则存在歧义、哪些场景可能被遗漏、哪些信息需要进一步确认,把依赖个人经验的“这里好像有问题”,转化成团队可以确认、跟踪和处理的明确问题。
本文将具体介绍需求缺口分析 Skill 适合什么时候使用、需要提供哪些输入、重点分析哪些问题、最终会产出什么,以及如何把分析结果带回真实的需求评审和测试流程中。
需求缺口分析 Skill 用来做什么
需求缺口分析 面向需要把测试判断讲清楚、交接出去的工作。它把项目材料、判断依据和下一步动作放在同一条线上——读者可以先知道该检查什么,再决定怎么执行与复核。本文用一个具体场景展开,并保留需要人工确认的边界。
先回到源 Skill
这个 Skill 的完整执行规则在 需求缺口分析 提示词。源目录还包含 3 个评测用例,用于验证输出是否遵守契约。
它要求特别注意:
- 不要替干系人填业务决策
- 区分事实、推断和问题
- 优先提出会导致返工或事故的缺口
用一份项目材料开始
先把当前拿得到的材料摆上来。缺口可以保留,状态必须说实话。
| 材料 | 这次填什么 | 缺失时的处理 |
|---|---|---|
| 目标与范围 | 分析会员升级需求中的规则缺口、未定义状态、异常路径和待确认决策 | 标出不在本轮判断内的链路 |
| 版本与环境 | 需求版本、构建号、环境和时间窗口 | 降级为设计或分析,不写执行结论 |
| 证据 | 需求、接口、日志、指标、trace 或历史缺陷 | 区分事实、假设和待确认项 |
| 决策边界 | 谁确认风险,哪些动作未经授权不能执行 | 列出 Owner 和下一步 |
可以这样调用:
请使用 requirement-gap-analysis Skill。
任务:分析会员升级需求中的规则缺口、未定义状态、异常路径和待确认决策
输入材料:[版本、链接、日志或报告路径]
范围:[本次包含和排除的对象]
限制:[时间、数据、权限、合规要求]
先审计输入,再按风险和证据强度排序。材料没有证明的内容标为假设,并列出验证方法。
产物要能被下一位同事接住
| 输出字段 | 作用 | 示例状态 |
|---|---|---|
| 发现或判断 | 说明观察到的行为、差异或风险 | 已确认 / 假设 / 待确认 |
| 依据 | 指向版本、日志、trace、测试或需求 | source_id 或链接 |
| 影响 | 说明受影响的用户、链路或发布判断 | P0、P1 或接受的残余风险 |
| 下一步 | 指定验证动作和负责人 | Owner、截止时间、预期证据 |
没有运行记录、查询结果或原始材料时,不写“已通过”。静态分析和实际执行是两件事。
在项目里跑一轮
先用一个边界清楚的小回合启动——分析会员升级需求中的规则缺口、未定义状态、异常路径和待确认决策。别急着把结果写成报告。先把输入版本、时间窗口和负责人贴到同一处;然后把每个判断连回具体材料;最后只安排一项能改变结论的验证动作。
缺口要区分事实缺失、规则冲突和实现待定,并指向确认人。这一轮交付应当包含:可复查的证据索引、仍然成立的假设、以及下一位同事可以直接执行的动作。这样做很朴素,也很有效。
在项目里跑一轮
先用一个边界清楚的小回合启动——分析会员升级需求中的规则缺口、未定义状态、异常路径和待确认决策。别急着把结果写成报告。先把输入版本、时间窗口和负责人贴到同一处;然后把每个判断连回具体材料;最后只安排一项能改变结论的验证动作。
缺口要区分事实缺失、规则冲突和实现待定,并指向确认人。这一轮交付应当包含:可复查的证据索引、仍然成立的假设、以及下一位同事可以直接执行的动作。这样做很朴素,也很有效。
进阶使用:把一次分析变成持续机制
缺口要区分事实缺失、规则冲突和实现待定,并指向确认人。
每次输出都保存输入版本和 source_id。下一次发生需求、代码、环境或数据变化时,只重算受影响的判断,并将结果标记为 changed、unchanged 或 needs-review。这样不会把旧结论当成新证据。
三段式 Skill 链
requirement-gap-analysis → acceptance-criteria-review → test-case-writing
| 交接 | 传递内容 | 接收方要检查什么 |
|---|---|---|
| 上游到 requirement-gap-analysis | 来源版本、范围、风险、未决项 | 输入是否过期,冲突是否标记 |
| requirement-gap-analysis 到下游 | 判断、证据索引、残余风险、待办 | 产物是否可执行,Owner 是否明确 |
| 下游回写 requirement-gap-analysis | 执行结果、缺陷、事实变化 | 是否更新基线与回归范围 |
交接时传摘要、证据索引和原始材料的位置。信息量足够,结论出了问题也能回到来源。
团队门禁
| 门禁 | 检查内容 | 未满足时 |
|---|---|---|
| requirement-gap-analysis 输入门禁 | 版本、环境、证据来源和 Owner | 停止生成,列出缺口 |
| requirement-gap-analysis 产物门禁 | 关键结论带依据、状态和影响 | 退回补证据 |
| requirement-gap-analysis 执行门禁 | 命令、查询或验证路径可复现 | 标记基础设施或测试问题 |
| requirement-gap-analysis 决策门禁 | 残余风险有接受人与日期 | 不进入下一阶段 |
容易踩的坑
- 只写检查点,不写输入条件、预期结果或证据。
- 把所有发现都标高优先级,团队无法取舍。
- 材料缺失时拒绝产出,或者反过来把猜测当成事实。
- 用一次成功或一次异常代表长期行为,忽略重复试验与版本差异。
两个实际问题
输入还不完整,能开始吗?
能。先交付受限初版:列出已知事实、假设、缺口和最小验证动作。环境、数据或权限缺失时,不写执行结论。
什么时候需要人工确认?
范围取舍、风险接受、生产操作、数据权限和发布决定必须由对应负责人确认。Skill 负责整理证据与选项,不替团队做授权决定。
先用一份真实材料跑通 需求缺口分析,把输入、产物、人工修改和验证证据留在同一个工作链里。下一次变化发生时,才有东西可以复用。