知识分享纪要

分享人：刘洋

记录人：张伟

时间：0000年9月13日 15:00–16:00

地点：产品研发中心培训角

出席：张伟、周敏、李婷等8人

一、分享目的

刘洋用60分钟分享他在9月接口联调里固定使用的四步核对。产品研发中心本月有3个接口在联调，此前两次因为字段名不一致返工，一次因为失败提示没写清而多等了一天。分享的目的是让张伟、周敏、李婷在各自的评审和说明里用上同一种核对顺序。陈静未出席，张伟于9月14日把纪要送她过目。

1. 听众8人，其中张伟负责记录，周敏负责会后把步骤贴到培训角。
2. 案例来自9月的3个接口，返工两次，等待多一天一次。
3. 分享不讲某一个接口的内部实现，只讲核对顺序。
4. 纪要在9月13日18:00前由张伟写入共享目录。

二、核心观点

刘洋的观点是：联调前按固定顺序核对四样东西，字段名、示例值、失败提示、超时时间。四步要按这个顺序做，示例值对着错误的字段名时，后面的提示和超时都会跟着错。他把这四样写成一张核对单，9月的第3个接口用这张单，联调一次通过。前两个接口没有这张单，各返工一次。

1. 四步顺序：字段名、示例值、失败提示、超时时间。
2. 第3个接口在9月10日一次通过，用时半天。
3. 前两个接口分别在9月3日、9月6日各返工一次。
4. 核对单由刘洋保存在共享目录，文件日期为9月10日。

三、操作步骤

第一步，双方把字段名逐个念出来，名称不一致的先改名再继续。第二步，用同一条示例数据各自算一遍，结果不一致就停。第三步，失败时的提示要写成用户能看懂的一句话，并约定谁来写。第四步，超时写成秒数，登录相关接口刘洋建议先按8秒记录现状、按3秒作为目标。每一步都在核对单上签名和日期。

1. 字段名不一致时，先改名，当天不进入示例值。
2. 示例数据只用一条，避免两个人用了不同的行。
3. 失败提示由写说明的人负责，李婷在对外说明里用同一句。
4. 超时同时写现状和目标，例如现状8秒、目标3秒。

四、问答记录

16:00前有三个问题被回答。周敏问核对单谁保存，刘洋答由接口负责人保存，评审前把单子链接放进材料。李婷问对外说明要不要写秒数，刘洋答对外只写用户看得到的提示，秒数留在核对单。张伟问评审材料里放哪一步，刘洋答四步都写一行，不必贴全部字段。三个回答都已写入纪要。

1. 周敏：核对单随接口走，评审材料里放位置，由负责人在会前放好。
2. 李婷：对外说明写提示原文，秒数不写进客户看到的文本。
3. 张伟：评审材料每步一行，共四行，不贴完整字段表。
4. 无人提出增加第五步，四步维持到下一次分享再看。

五、转化行动

散会时定了四件行动。张伟在9月20日前把四步各写成一行，放进下一次需求评审材料的固定末段。周敏在9月16日前把四步抄在培训角白板上。刘洋在9月18日前用第3个接口的核对单当例子，给张伟一份可照抄的空白单。李婷在9月24日的对外说明里使用已经写好的失败提示原句。

1. 9月20日前：张伟把四行核对写进评审材料末段。
2. 9月16日前：周敏把四步写到培训角白板。
3. 9月18日前：刘洋交出一份空白核对单，字段留空、步骤留着。
4. 9月24日：李婷的对外说明使用失败提示原句。