用 WorkBuddy 做「一次一改」的变更记录:只记改了哪一行

用 WorkBuddy 做「一次一改」的变更记录:只记改了哪一行

批量改一批数据或配置时,最怕事后说不清「到底动了哪里」。全量备份能回退,但回退也把这次该留的改动一起撤了。这次用 WorkBuddy 做了一份「一次一改」的变更记录,核心规矩是:每改一处,只记录那一行的前后值。

记录格式

字段内容
对象改的是哪个文件、哪条记录
字段具体哪个字段
改前原来的内容
改后改完的内容
原因一句话

「只记一行」是铁律。试过写成「调整了配置」,回头完全想不起调了什么;写成前后值对照,回看零歧义。

工具负责什么

把改动前后两份内容交给 WorkBuddy,要求逐字段比对,只输出发生变化的那些行,按上面格式列成表格;不改写、不概括、不替我做判断。这与 WorkBuddy 文档 里强调的「先说清输入与边界再执行」一致:把「只列差异」写进要求,就不当事后挑错的苦力。

关于「记录要结构化成可取到的值」,HTML 入门教程 讲结构化数据时的朴素原则同样适用:一行一个变化,机器和人都能稳定读,不靠在长文里找。

用了一段时间的体会

  • 变更记录本身成了最小回退单位:想撤某处,只还原那一行,不影响别的。
  • 靠它抓出过两次「以为改了、实际没改」的情况,因为前后值一对比就露馅。
  • 原因那栏倒逼自己在改之前想清楚为什么,冲动型改动少了很多。

适用边界

适合结构化、可逐行比对的内容:配置、表格、参数。长段自由文本的差异更适合「版本快照」而非逐行记录,硬拆反而难读。另外,记录要在改完立刻做,隔天就记不清改前是什么了。

小结

一次一改、一行一记,变更就从「一团改动」变成可逐条回退的清单。对象、字段、改前、改后、原因,五栏够用。