先给结论:如果供应商只交文档,你要把“交付物”和“实施权”拆成两条接口。一条是文档接口,规定格式、字段、验收标准;另一条是实施接口,规定谁改、改在哪、改完谁验证。两条接口不拆开,文档就会变成没人认领的待办清单。
同样是“只交文档”,背后的关系完全不同,接口设计也不同。
区分依据很简单:问一句“如果明天联系不上对方,这份文档还能不能推动改动”。能,就是条件一已经接近完成;不能,说明接口还缺执行层信息。
只交文档最常见的失败,是文档写了“优化标题和描述”,但没写改哪个页面、改成什么、依据是什么。设计接口时,把每一项拆成四个必填字段:
一个假设例子:供应商交来一份旧栏目页清单,只写“内容过时,建议重写”。按上面的接口,你需要它补成“某栏目页,当前正文停留在三年前的产品分类,建议合并到新分类页并设置跳转,验证方式是旧链接仍可访问且指向新页”。补不齐,就不进入实施环节。
文档合格不等于能落地。实施接口至少要写清三件事:
实际动作:在文档交付后,先挑一条影响面最小的建议做试点实施。如果试点能顺利完成,说明接口字段够用,再批量推进;如果试点卡在“不知道改哪里”,就退回文档接口补字段,而不是硬推全部清单。这个动作的结果直接决定下一步是扩量还是返工。
例外存在,但要写进约定。如果旧系统即将整体下线,文档只用于留档,那么实施接口可以省略,文档接口也可以只保留结论和日期。反过来,如果旧内容仍有流量价值、需要保留并迁移,就不能省实施接口,因为迁移动作本身会影响可访问性。
另一个例外是供应商愿意在文档里附带可执行的配置片段或模板示例。这时实施接口可以简化,但仍要指定谁负责应用和验证,不能默认文档作者会跟进。
旧合作关系结束时,不必全盘接收。优先保留三类内容:仍被引用的页面清单、已验证有效的结构调整说明、以及能解释历史决策的背景记录。可以丢弃的是过期关键词清单、没有对象指向的泛泛建议、以及无法验证的结论。
判断标准是“离开原供应商后还能不能用”。能独立执行并验证的留下,需要对方口头解释才能懂的,要么补文档,要么放弃。这样设计接口,文档才不是交接仪式的摆设,而是能推动下一步动作的工作底稿。