文档里写了“建议修改标题结构、压缩页面层级、补充内链”,但对方不进入后台、不改模板、不发内容,只把PDF或表格交给你。此时真正要设计的不是验收清单,而是双方接口:谁把文档里的动作变成线上变更,谁提供变更所需的权限和字段,谁在变更后确认结果。接口设计得清楚,文档才有用;设计不清,交付物再厚也只能停在建议层面。
同样是只交文档,背后可能是两种完全不同的合作状态,不能用同一种接口去接。
一种解释是供应商的能力边界本来就在诊断和策略,不包含开发、内容生产或后台操作。这类合作成立的前提是:你方有能执行的前端、后端或内容编辑,并且愿意为执行结果负责。接口重点应放在“文档到工单”的转换上,供应商交付的不是结论,而是可被直接派发的动作。
另一种解释是责任切割:供应商愿意写建议,但不愿对建议落地后的结果负责,也不愿承担改错模板、改乱结构、误删页面的风险。此时接口重点不是动作派发,而是责任边界:哪些改动必须由你方确认后才能执行,哪些改动供应商只提供判断依据、不参与决策。
两种解释都成立,但适用条件不同。如果你方没有执行人力,只交文档的模式基本不成立;如果你方有执行人力但缺少判断依据,这个模式反而可能比“全包实施”更可控,因为每一次线上变更都经过你方确认。
不要靠对方口头表态判断,看三个可验证的迹象。
这三个证据指向同一个判断:对方是否把你方的执行能力当作合作前提。前提成立,接口可以按“文档—工单—变更—反馈”设计;前提不成立,就要先把执行资源补齐,否则接口设计得再细也无人执行。
只交文档时,最容易出问题的地方是文档和建议之间没有映射关系。一份文档里混着“必须改”“建议改”“可选改”,执行方无法判断优先级,最后往往只改了最容易改的几条。
可行的做法是要求每条建议都落成固定字段,字段不必复杂,但要能直接派工:
假设一个场景:文档建议把某产品分类页的标题从“产品中心”改为“工业传感器选型”。执行方改完后,发现该分类页在站内搜索中的入口名称与页面标题不一致,用户从导航进入时产生困惑。这时验证方式如果只写“标题已更新”,就不会发现入口不一致;如果写“站内搜索和导航入口同步检查”,就能在下一步决定是改导航还是回退标题。这个例子说明,验证字段决定的是下一步动作,而不只是记录完成状态。
只交文档的模式下,供应商通常保留判断权,你方保留执行权和上线权。这个划分本身合理,但需要在接口里写清三个节点。
变更前:供应商提供动作单元和优先级,你方确认执行窗口和权限。涉及模板、跳转规则、批量删除的动作,应由你方指定一名最终确认人,避免多人同时改。
变更中:执行方按动作单元操作,遇到文档未覆盖的情况暂停并回问,不自行扩大改动范围。供应商在约定时间内回应,回应内容仍以动作单元形式返回,而不是重新发一份完整文档。
变更后:你方按验证方式检查并记录结果,把异常反馈给供应商。供应商据此判断是继续下一批动作,还是先处理异常。这个反馈环节是区分“文档交付”和“接口协作”的关键;没有它,双方只是在各自完成自己的部分。
如果供应商只愿意交文档、不愿意回应执行反馈,那么接口实际只覆盖到变更前,变更中和变更后都由你方独自承担。这种合作可以继续,但你要按“无反馈接口”来配置内部资源,而不是按“有反馈接口”来排期。
出现以下条件时,继续维持只交文档的模式会让执行成本超过收益:你方执行人力持续不足,动作单元积压超过一个交付周期;同一类改动反复出现在多份文档里,说明缺少统一执行;或者变更涉及模板层和跳转规则,执行错误的影响面已经超出单页范围。
反过来,如果你方执行人力稳定、变更影响面可控、供应商能持续回应执行反馈,只交文档的模式可以继续,而且比全包实施更容易留下内部可复用的操作记录。决定点不在于哪种模式更“完整”,而在于执行反馈是否真的在发生。接口设计的目标,是让每一条文档建议都能被派发、被验证、被回退,而不是让文档看起来更厚。