先给结论:验收通过只说明交付物符合约定清单,不能说明它能在你的站点、流程或权限下真正跑起来。界定缺口的关键动作,是把交付物放进真实环境执行一次最小用例,记录失败发生在哪一层,再决定是要求补齐、调整验收标准,还是终止合作。如果无法执行,缺口就属于环境与权限,而不是交付质量。
交付物能打开、能读、格式正确,却用不上,通常落在两类原因里。区分它们决定你下一步找谁。
判断方法很简单:把同一份交付物分别放进对方提供的环境和你自己的环境各跑一次。两次都失败,偏能力缺口;只有你的环境失败,偏环境缺口。这个动作的结果直接决定你是要求返工,还是要求补充部署支持。
如果验收标准只列了文件数量、格式、字段名,那么“能用”本身不在验收范围内。此时缺口是真实的,但属于合同未覆盖的部分。
可做的动作是:整理一份最小可用用例,写明输入、期望输出、实际结果,发给对方确认是否属于原范围。若对方确认超出范围,你有两个选择——追加一份小范围实施支持,或自行补齐。选择依据是内部是否有人能读懂交付物并完成部署。若团队里没人能解释交付物里的字段和逻辑,自行补齐的成本通常高于追加支持。
例外:如果交付物里包含明显自相矛盾的内容,例如同一字段在文档和代码里含义不同,这不再是范围问题,而是交付质量问题,可以直接要求修正,不必先谈追加。
如果验收标准写的是“上线后可访问”“数据可导入”“策略可执行”,那么能打开但跑不起来就是未完成。此时不要接受“文件已交付”的说法。
动作上,先固定证据:截图、日志、报错信息、复现步骤,按时间顺序整理。然后要求对方在你的环境里完成一次完整执行,而不是再发一份说明文档。执行成功后,再重新走验收。执行仍失败,则按未完成处理,进入返工或扣减流程。
这里有一个容易被忽略的点:请求量下降、抓取异常或某项统计归零,都不能单独证明交付物有问题。它们也可能是流量结构变化、站点改版或外部依赖波动的结果。要把它当作线索,而不是结论,回到最小用例去验证。
假设某团队交付了一份结构化数据模板,验收时文件格式、字段名、示例值都正确。上线后页面却没有按预期展示。此时不要直接判断模板错误。
这个例子的价值不在于结论,而在于它把“能不能用”拆成了可核对的一步,避免用感觉争论。
要改,而且要在下一次合作前改。把“可运行”写进验收条件,比事后争论有效得多。具体可以加三条:交付物需在指定环境完成一次最小用例;需附部署或导入说明;需注明依赖项与权限要求。
如果对方拒绝把可运行纳入验收,而你的团队又没有独立实施能力,这个信号比任何单次缺口都更值得重视。它意味着后续每一次交付都可能重复同样的争议。此时更合理的做法是缩小合作范围,只采购你能独立验证的部分。
缺口界定不是找责任,而是决定下一步把资源投在哪。能复现的失败指向交付物,不能复现的失败指向环境,两者需要完全不同的处理方式。