先别急着改步骤文档,也不要立刻认定界面出了问题。更有效的做法是:把“步骤说会看到什么”和“界面上实际出现什么”各写成一条可核对记录,再让分歧落在同一个可复查的对象上。若两者都能稳定复现,说明是版本或权限差异;若只有一方能复现,说明是操作路径或环境差异。这一步决定了接下来是改文档、改流程,还是继续排查。
界面事实指屏幕上能看到的状态,例如某个按钮是否存在、某列数据是否为空、提示语写了什么。操作事实指人做了哪些动作,例如先点了哪一项、在哪一步输入、是否切换过账号。两类事实混在一起时,讨论会变成互相否认。
可以按下面这个顺序拆:
如果第一个不一致节点出现在登录之后,优先核对账号权限与所属项目;如果出现在数据加载之后,优先核对筛选条件和时间范围。这样定位范围会明显收窄。
当两个人分别按自己的方式操作,都能重复得到各自的结果,说明差异不是偶发。此时不要争论谁对,而是先确认两边是否处在同一版本、同一权限、同一数据范围。常见原因是文档更新滞后于界面调整,或某角色使用的是受限视图。
实施动作:让双方各自录一次从进入页面到出现分歧节点的完整路径,只记录位置、动作、结果,不写评价。把两份记录并排后,通常能直接看出分叉点。这个动作的结果会决定下一步:若分叉点在权限,就补一份分角色步骤;若分叉点在版本,就标注适用版本并安排更新文档。
时有时无通常不是文档问题,而是环境或时序问题。例如缓存、筛选残留、数据尚未刷新、多人同时改动同一配置。此时改步骤文档没有意义,因为问题不在描述,而在复现条件。
实施动作:让无法稳定复现的一方固定三项条件再试——同一账号、同一入口、同一时间范围,并在每次尝试前记录当前筛选状态。若固定后仍不能复现,再检查是否有人在此期间改过配置。这个动作的结果会告诉你:是继续排查环境,还是先冻结改动再做一次对照。
可核对项目要满足三个要求:指向唯一位置、包含可观察结果、能被第三方重复。下面是一份可以直接套用的最小结构,字段名可以按团队习惯调整。
填写时只写观察到的事实。若某一栏写不出来,说明该节点还没有被真正核对,应回到上一步补记录,而不是先下结论。
假设步骤文档写“点击导出”,但界面上只有“下载”。两人各执一词。按上面的结构记录后可能得到两种结果。
若两人在同一账号下都只看到“下载”,判定为文档滞后,动作是更新文档用词,并在变更记录里注明旧称。结果是后续交接不再出现同一疑问。
若一人看到“导出”、另一人看到“下载”,且各自稳定复现,判定为版本或权限差异。动作是先确认两人是否在同一项目、同一角色,再决定是补分角色说明还是统一入口。结果是排查范围从“界面对不对”缩小到“谁在什么条件下看到什么”。
这个例子里的名称只是示意,实际以你所在环境看到的为准。
如果分歧涉及正在调整的配置,继续边改边查会让记录失去参照。此时更合理的动作是暂停改动,固定一个时间点,让各方基于同一状态重新记录一次。若暂停后分歧消失,说明之前的差异来自改动过程中的中间状态,而不是步骤本身。
例外情况:若分歧只出现在数据加载缓慢时,且刷新后一致,优先按加载时序处理,不必冻结全部改动。判断依据是分歧是否只在特定时序下出现,而不是看谁的声音更大。
定位的终点不是证明谁对,而是让下一个执行的人能按记录得到同一结果。只要记录能指向唯一位置、包含可观察结果,并且写明了复现条件,这次分歧就已经转成了可核对的资产。