技能介绍

联调前缺的不是接口文档，而是共识

和外部系统对接时，常见状态是：会议纪要、群聊截图、口头分工散落在各处，发给对方 IT 时要么缺字段映射，要么把「听说对方支持」写成已定 SLA。本技能把这类零散信息收成可转发的一页集成说明，固定五块：场景（目标、主流程与明确不做的事）、字段 / 数据流（方向、必填与映射，缺则标待确认）、责任（轻量我方/对方分工，非完整 RACI）、联调窗口（环境、计划区间与验收口径）、待双方确认（禁止编造对方能力或日期）。

怎么用、输出长什么样

在助手里说清「给谁、什么场景」即可；缺对接双方或目标场景时会先追问。流程大致是：

澄清最少项：双方系统、目标场景、已知字段或接口线索、联调意向、已知分工（均可缺，缺则待确认）
按 references/brief-template.md 结构填一页；对方未确认的不得写成「对方已同意」
责任用「事项 + 我方 + 对方」表；联调窗口无日期则待确认，并提示补齐后再外发
自检：是否误做成完整 OpenAPI、API 变更通知，或写入用户未提供的对方截止日

信息极少时（只知道「要对接」）：不硬填字段表，结构保留但整表待确认，主交付转为按对接形式、数据范围、技术约定、项目信息分组的信息索要清单，并在标题/版本处标注「信息收集稿，不构成任何约定」。

边界

面向首次/业务对接共识，不做完整 OpenAPI/SDK、网关配置、安全评审细则，也不代合同/法务或代发邮件。已上线 API 的破坏性变更请用 api-consumer-notice；内部 kickoff 对内宣讲请用 kickoff-onepager。技术对齐草案法律效力以合同为准。