返回工具库
第 4 章 · 交付模板
接口契约重写卡
把跨团队协作从猜测变成验收
重写跨团队或人机协作接口，明确输入、输出、标准、时间窗和责任归属。
交付时长
35-50 分钟
参与人数
3-10 人
在线化状态
可按模板交付
产出物
接口契约 v1、验收标准、责任边界
适用对象
流程负责人OD 负责人项目负责人
需求设计手册
已生成 Markdown 手册，路径：
docs/tool-products/interface-contract.md解决的问题
很多协作问题看起来是态度问题，其实是接口没有写清楚。谁给谁什么、什么时候给、好坏怎么验收、出错谁修订，都靠猜测，自然会反复确认和责任漂移。
使用边界
适合使用
- 跨部门反复返工
- AI 输出进入流程后无人验收
- 团队之间对交付标准理解不一致
不适合使用
- 冲突来自战略优先级而非接口不清
- 没有明确上下游关系的开放讨论
现场交付流程
1
定义接口双方
写清谁是上游、谁是下游，AI 或自动化是否作为接口参与者。
产出：接口角色
2
写输入输出
用可检查语言写清输入材料、输出结果和格式要求。
产出：输入输出定义
3
写验收标准
写清通过、退回、人工复核和例外处理的标准。
产出：验收清单
4
约定修订机制
写清接口失效时谁发起修订、多久复盘一次、证据如何保留。
产出：接口契约 v1
解释口径
- 接口契约不是越细越好，而是能减少最常见的不确定性。
- 如果验收标准无法观察，说明还没有写到位。
主持人提示
- 从一次真实返工倒推接口缺口。
- 要求双方共同确认，避免单方面制定标准。
常见误区
- 把契约写成责任追究书。
- 只写流程节点，不写验收信号。
输出模板
接口契约 v1
- 上游是谁？
- 下游是谁？
- 输入是什么？
- 输出是什么？
- 验收标准是什么？
后续开发说明
表单字段
- upstream
- downstream
- input
- output
- qualityStandard
- timeWindow
- owner
- reviewCycle
报告模块
- 接口契约卡
- 风险点
- 修订提醒
验收标准
- 用户能生成一页接口契约
- 字段能覆盖人、AI、自动化角色
- 支持打印或导出模板
后续行动
- 将接口契约纳入人机链路五步法。
- 两周后用真实协作结果修订 v2。
可按模板交付
已具备结构化字段，适合下一步开发在线填写、导出或协作版本。