Build the Lever(构建杠杆)是一条适用于任何非平凡工作的原则,而不只是批量工作。它的核心主张是:当工作不是琐碎小事时,应当构建能完成该工作的工具,而不是手工去做。
用途与理念 一个 codemod、生成器或脚本每次都以相同方式完成工作,并且可以免费重跑。工具是一件产物,审查者可以阅读它、重跑它来检查工作结果。手工完成的改动只能通过重做来重新验证。一个确定性的脚本把“相信我”变成“运行这个”。
何时适用 该原则适用于任何非平凡工作,包括编辑、迁移、分析、检查等。默认做法是构建杠杆。只有当任务确实琐碎——即几个一眼就能看清的明显编辑——时才跳过。
判断标准 门槛是“琐碎”,而不是“重复”。即使是一次性任务,只要杠杆能让工作变得可检查,也值得构建杠杆。按照 Laziness Protocol,应构建能完成或证明该工作的最小脚本,而绝不是一个框架。
使用方式 先手工完成第一个单元,以摸清配方,然后构建工具。通过在该单元上重跑工具,并与手工完成的版本做 diff 来验证它。让杠杆可以安全地重跑。
具体形式 编辑用 codemod 或脚本;重复性文件用生成器;分析用 dump-to-sqlite 查询;验证用可重跑的检查。
与并行分派的关系 确定性的杠杆胜过 fan-out。如果工具能一次处理所有单元,就自己运行它。不要把工作分派给多个代理去手工套用脚本能完成的事情。 当把工作分派给子代理时,把杠杆写成一个它们都会读取的 skill:配方、验证契约和“禁止触碰”的围栏都放在同一件产物中。把它放在委派者的写入范围之外,这样它们就无法悄悄修改契约。
可检验性 应用这条原则会产生一个文件。如果你引用了它,而 diff 中却没有 codemod、脚本、生成器或委派 skill,那就说明你没有应用它。
持久化 当工作会超出当前会话时,提交这个杠杆。
与其他原则的区别 本原则不同于 Encode Lessons in Structure(把反复出现的指令变成持久的护栏)。本原则关注的是眼前工作的吞吐量和可审查性。关于把验证本身脚本化,参见 Prove It Works。