用途
“构建杠杆”(Build the lever)是一条关于如何组织重复性工作的原则。它的核心主张是:当某项工作会反复出现,或者某项检查很难靠人工可靠完成时,把它变成可重复运行的工具,从而节省精力,并让结果可以被独立核验。
它同时划定了边界:如果已有命令或一次直接的小改动就足够,就不必构建工具。
主要能力与做法
- 先复用,再构建:先寻找已有的命令、查询、codemod 或检查手段是否覆盖该任务。若足够,就用记录下来的输入和调用方式复用它。新建文件本身并不证明其有用(对应原则 principle-reuse-before-building)。
- 先做代表性单元:对于没有现成方案覆盖的重复转换,先完整完成一个有代表性的单元,以此确立“配方”。
- 构建最小工具并比对:构建最小的工具,并将其输出与预期结果进行比对。
- 结构感知编辑:在纯文本替换可能改动无关内容时,使用结构感知的编辑方式。
- 覆盖异常与重跑安全:在应用到所负责的范围之前,先演练异常情况、失败处理和重跑安全性。
- 保留无关工作:保留无关的工作内容,并把跳过或不确定的单元暴露出来供审查。
- 保留有价值的工具:如果该工具的审查或复用价值会超出当前任务,就保留它,并附带可复现的调用方式和结果检查。
- 一次性任务也可成工具:如果构建工具是证明结果最经济的方式,一次性任务也可以获得一个工具;但不需要框架。
- 优先确定性执行:相比手工铺开,优先选择确定性的执行过程。若授权且有用,可以委派,但需共享一份稳定的配方、验证契约和写入边界;委派是可选的。
使用方式
该原则以判断准则的形式使用:在动手前先问“是否已有现成手段”“这项工作是否会重复”“结果是否需要独立核验”。若答案为是,则按上述步骤先复用、再构建最小工具、先验证代表性单元、再处理异常与重跑安全,最后在受控范围内应用。
适用场景
- 重复性的转换或处理工作。
- 难以人工可靠完成的检查。
- 需要可复现、可独立核验结果的任务。
- 需要把一次性验证结果沉淀为可复用手段的场合。
限制与边界
- 不适用于已有命令或一次直接小改动即可完成的情况。
- 新建文件不等于有用,必须能复用或能核验。
- 不需要为此引入框架。
- 委派是可选的,不是必须。
与其他原则的区别
- 与 principle-reuse-before-building 的区别:后者关注在准备编写 helper、owner、script 或组件时,是否已有现成选项可以覆盖。
- 与 principle-encode-lessons-in-structure 的区别:后者针对已验证的经验反复出现、需要持久防护的情况。
- 与 principle-prove-it-works 的区别:后者关注声称某个结果可用时,运行最小的直接检查。
完成标准
工作及其检查可以借助已有或新建的杠杆复现;或者直接方法因总投入更低且置信度相当而被证明合理。