先给结论:供应商只交文档不实施时,接口的核心不是“把文档要得更全”,而是把文档拆成可被对方或自己执行的动作单元,并约定每个动作的输入、输出和验收证据。如果文档无法转成动作,保留它的意义有限;如果双方对“谁执行”没有书面边界,后续分歧会反复出现。
同一份文档,双方理解不同,通常落在三种分歧上。第一种是动作归属分歧:文档写了“优化栏目结构”,供应商认为这是建议,你方认为这是交付内容。第二种是颗粒度分歧:文档只给方向,没有给到可执行的字段、模板或判断标准。第三种是验收口径分歧:双方都认可要做,但对“做完”的判定不同。
判断方法很简单:把文档里每条建议逐条问一句“这条由谁在什么时间、用什么账号、产出什么可见结果”。如果三条都答不上来,它更接近方向说明,而不是实施接口。此时保留原文、改写为任务卡,或直接退出该部分合作,取决于你方是否具备自己执行的能力。
接口不需要复杂,但必须能让双方独立核对。建议每条任务至少包含以下字段,缺一项就标为待确认,而不是默认对方会补。
动作:具体到可操作的动词,例如“改写某栏目页标题与描述”“补充某类页面的内链入口”,而不是“提升相关性”。输入:执行需要谁提供什么,例如页面清单、账号权限、品牌用词表、已有内容样本。输入不到位时,任务应停在待启动状态。输出与证据:产出物是什么,以及用什么证明完成,例如修改前后的页面截图、字段对照表、可复查的页面地址。证据要能被第三方复核,而不是只写“已完成”。一个假设例子:文档写“优化产品页关键词布局”。改写后可变成——动作:为指定产品页补充标题、描述与正文小标题;输入:产品页清单与品牌禁用词表;输出:一份字段对照表,标明每页改前改后内容。假设双方约定先做五页作为样本,那么这五页的对照表就是接口是否跑通的证据。若对照表无法产出,说明输入或权限没到位,下一步应先解决输入,而不是继续扩大页数。
保留适用于文档方向本身有价值、你方内部有执行人手,且双方愿意把验收放在你方一侧。此时供应商的角色接近顾问,接口重点是定期对齐判断标准,而不是催交付。前提是你能接受执行节奏由自己控制。
改写适用于文档方向可用但颗粒度不足,且供应商愿意配合把方向拆成任务。改写时要一次只改一类任务,改完立即确认,避免整份文档反复返工。若对方拒绝确认动作归属,改写就很难推进。
退出适用于文档既无法转成动作,又无法明确输入输出,且双方对验收口径持续不一致。退出不等于否定全部内容,可以先退出无法核对的部分,保留能独立验证的部分。判断退出是否合理的依据,是继续沟通的成本是否已经高于你方自己执行的成本。
设计完接口后,挑一个范围最小、依赖最少的任务做试跑。试跑的目的不是看效果好坏,而是看三件事:输入是否按时到位、输出是否符合约定格式、验收人是否能独立判断。试跑结果会直接影响下一步——如果输出格式反复对不上,应先修接口字段;如果输入总是缺,应先修责任分工;如果验收人无法判断,应先补判定标准。
需要说明的是,试跑期间页面抓取量、收录量或某项统计出现零变化,不能单独证明接口设计正确或错误。这些现象还可能有其他合理解释,例如页面尚未被处理、统计口径不同、样本量太小。把它们当作唯一证据,容易把执行问题误判成方向问题。
每次对齐后,用一份简短记录固定三件事:本次确认了哪些动作、哪些仍待确认、下一次核对的时间点。记录不需要长,但要能让没参会的人看懂谁负责什么。这样做的实际作用是,当后续出现“我以为你会做”时,可以回到记录判断是接口没写清,还是执行没跟上,而不是重新争论整份文档。
如果供应商只交文档不实施,双方接口的设计重点始终是让文档落到可执行、可核对的动作上;保留、改写或退出,都应基于这个判断,而不是基于文档看起来是否完整。