验收通过却用不起来的典型缺口,不在交付物本身,而在“从交付物到可运行状态”之间那段没人负责的转换。界定缺口的方法是把验收标准拆成两层:文件层(有没有、对不对)和运行层(在目标环境里能不能产生预期结果)。只有运行层的失败能被复现,缺口才算被界定清楚,否则只是主观感觉。
同一个现象——“东西在,但用不了”——至少有两种成立条件完全不同的解释。
两种解释对应的责任方和补救动作完全不同。若不做区分就要求返工,很可能把“补一份使用条件”变成“重做一遍交付物”,成本翻倍且问题依旧。
主观争论无法定责,需要一组可观察的证据。下面两个动作成本低、区分度高。
找一位没有参与制作、但具备同等技能的同事,只给交付物和随附说明,不给口头补充。记录他在哪一步停住、停住的原因是什么。
把同一份交付物分别放进目标环境和交付方的原始环境执行,对比结果。
这个动作的结果会直接决定下一步:指向解释二时,下一步是补交接材料并约定“谁负责在目标环境里跑通”;指向解释一时,下一步才是返工,并且返工范围应限定在能复现失败的那部分,而不是整体重做。
文件层验收通常只问“交付物是否存在、格式是否正确”。要避免“验收通过但用不了”,需要在验收口径里补一条运行层标准,并明确它的执行者。
一个可用的写法是:由接收方在目标环境中独立执行一次,达到约定的预期结果,且执行过程中不需要向交付方索取额外说明。这条标准把“能不能用”变成可判定的动作,而不是印象。
需要说明适用条件:这条标准要求目标环境在验收前已经确定并可访问。如果目标环境尚未就绪,运行层验收无法执行,此时应把验收拆成两次——文件层先过,运行层在环境就绪后补验,并在合同或任务单里写明补验的时间点和责任方。否则缺口会被推迟到项目结束后才暴露。
假设某次交付包含一份规则文件,打开后格式正确、字段齐全,文件层验收通过。但在目标系统里导入后没有产生任何预期输出。
按上面的方法排查:换一位同事按同样步骤操作,同样没有输出;把同一文件放回交付方的原始系统,能正常输出。两个证据叠加,指向解释二——缺少目标系统所需的某项配置或导入前置步骤。
此时正确的下一步不是重写规则文件,而是要求交付方补一份“在目标系统中从零到跑通”的操作记录,并由接收方按该记录再执行一次。若第二次仍失败,且失败点与第一次相同,才转为解释一处理。这个例子中的数字只用于说明比较方法,不代表任何真实项目的规模或结果。
缺口被界定清楚之后,处理顺序影响返工量。
需要提醒的是,抓取量、请求量或某项统计归零,不能单独证明交付物有缺陷,也不能单独证明处理正确。它可能来自环境变化、访问限制或统计口径调整。判断缺口仍要回到可复现的运行结果上。界定缺口的终点,是一句能被双方复述的话:在什么环境下,由谁执行,卡在哪一步,缺的是材料还是修复。