远程交付能否被复现,取决于对方是否把“环境、操作、验证”三件事同时交出来。只给录屏或只给命令,内部人员通常只能照做一次,换台机器或换个人就卡住。下面用一个假设情境,说明两种常见做法的取舍条件。
假设你从荆门建站公司拿到一套企业站,对方远程完成部署后,需要你们内部两名同事接手日常发布和故障排查。对方给出两种交付方式:
两种方案都合理,但适用条件不同。判断标准不是“哪个更专业”,而是:这套操作未来由谁执行、多久执行一次、出错后能否自己回退。
录屏方案成立的前提是操作低频且路径唯一。例如一年只改一次备案信息、只换一次统计代码,执行人固定,出错后可以直接找原交付方。此时录屏加要点足够,成本也低。
但以下任一条件成立,录屏就不够:
可执行文档的核心不是写得长,而是每一步都包含前置状态、动作、预期结果。缺少预期结果,执行人无法判断自己是否做对,只能靠猜。
不管选哪种方案,复现能力都落在三样东西上,缺一样都会在第二次执行时暴露问题。
列出运行版本、依赖名称、目录用途和必要的配置项来源。不要写“按常规配置”,要写清楚哪个值来自哪里。例如配置文件里出现 <API_BASE> 这类占位符时,要说明它对应哪个环境的哪个值。
每一步都写清执行后应看到什么。例如“执行构建命令后,输出目录应新增一个带哈希的静态文件;若目录为空,先检查依赖是否安装完整”。这样执行人不必依赖记忆判断对错。
这是最容易被省略、却最能暴露问题的一步。让对方旁观你们的人独立操作,卡住的地方就是文档的缺口。演练后修订文档,而不是口头补充。
具体做法是:选一名没有参与原交付的同事,只给他文档,不给录屏,让他在自己的电脑上完成一次完整发布。交付方在旁记录,不主动提示。
结果通常分三类,对应不同的下一步:
这个动作的价值在于:它把“看起来会了”变成“确实能做”。演练通过后,你们再决定是否还需要录屏作为辅助材料,而不是一开始就默认录屏等于交付。
录屏方案交付快、沟通成本低,代价是复现能力集中在少数参与过会议的人身上,人员变动后容易断档。可执行文档加演练交付慢一些,需要双方各投入一次完整时间,代价是前期占用人力,收益是后续操作可以脱离原交付方。
如果这套站点的日常改动频率低、执行人稳定,可以接受录屏方案的代价;如果发布频繁、涉及多人或需要自行排障,那么反向演练就不是可选项,而是交付的一部分。把这条边界在合作开始前说清,比交付后再补文档更省事。