本地项目经常不是败在代码本身，而是败在路径、Shell、运行时和工具链的细小差异。可复现工作流的目标，是让下一次接手不必重新猜。
把环境差异写进步骤
Windows 上同一个工具可能同时存在 PowerShell 包装脚本、命令行程序和随软件附带的运行时。记录真正成功的入口，比只写工具名称更有用。
路径里有空格、脚本策略受限或缺少系统级运行时，都应该被视为工作流的一部分，而不是维护者自己应该猜到的背景知识。
成功命令后面要跟验证
构建命令退出为零，只能说明构建阶段没有报告失败。还需要检查测试、静态规则、关键页面和产物内容，才能确认交付真的可用。
如果一次发布包含自定义域名，还要把默认地址、域名状态和线上响应分开验证。部署完成与访客真正能打开页面不是同一个结论。
只保留能帮助下一次的信息
好的运行记录不需要收集全部终端输出。留下工作目录、关键命令、确认结果、失败边界和下一步，已经足以把偶然成功变成可复现路径。