用 WorkBuddy 做「一次一改」的变更记录:只记改了哪一行
批量改一批数据或配置时,最怕事后说不清「到底动了哪里」。全量备份能回退,但回退也把这次该留的改动一起撤了。这次用 WorkBuddy 做了一份「一次一改」的变更记录,核心规矩是:每改一处,只记录那一行的前后值。
记录格式
| 字段 | 内容 |
|---|---|
| 对象 | 改的是哪个文件、哪条记录 |
| 字段 | 具体哪个字段 |
| 改前 | 原来的内容 |
| 改后 | 改完的内容 |
| 原因 | 一句话 |
「只记一行」是铁律。试过写成「调整了配置」,回头完全想不起调了什么;写成前后值对照,回看零歧义。
工具负责什么
把改动前后两份内容交给 WorkBuddy,要求逐字段比对,只输出发生变化的那些行,按上面格式列成表格;不改写、不概括、不替我做判断。这与 WorkBuddy 文档 里强调的「先说清输入与边界再执行」一致:把「只列差异」写进要求,就不当事后挑错的苦力。
关于「记录要结构化成可取到的值」,HTML 入门教程 讲结构化数据时的朴素原则同样适用:一行一个变化,机器和人都能稳定读,不靠在长文里找。
用了一段时间的体会
- 变更记录本身成了最小回退单位:想撤某处,只还原那一行,不影响别的。
- 靠它抓出过两次「以为改了、实际没改」的情况,因为前后值一对比就露馅。
- 原因那栏倒逼自己在改之前想清楚为什么,冲动型改动少了很多。
适用边界
适合结构化、可逐行比对的内容:配置、表格、参数。长段自由文本的差异更适合「版本快照」而非逐行记录,硬拆反而难读。另外,记录要在改完立刻做,隔天就记不清改前是什么了。
小结
一次一改、一行一记,变更就从「一团改动」变成可逐条回退的清单。对象、字段、改前、改后、原因,五栏够用。