SuperAPI AI 工具集

principle-build-the-lever

通用与其它

查看项目

更新于 10-20 12:14

技能介绍

用途

“构建杠杆”(Build the lever)是一条关于如何组织重复性工作的原则。它的核心主张是:当某项工作会反复出现,或者某项检查很难靠人工可靠完成时,把它变成可重复运行的工具,从而节省精力,并让结果可以被独立核验。

它同时划定了边界:如果已有命令或一次直接的小改动就足够,就不必构建工具。

主要能力与做法

  1. 先复用,再构建:先寻找已有的命令、查询、codemod 或检查手段是否覆盖该任务。若足够,就用记录下来的输入和调用方式复用它。新建文件本身并不证明其有用(对应原则 principle-reuse-before-building)。
  2. 先做代表性单元:对于没有现成方案覆盖的重复转换,先完整完成一个有代表性的单元,以此确立“配方”。
  3. 构建最小工具并比对:构建最小的工具,并将其输出与预期结果进行比对。
  4. 结构感知编辑:在纯文本替换可能改动无关内容时,使用结构感知的编辑方式。
  5. 覆盖异常与重跑安全:在应用到所负责的范围之前,先演练异常情况、失败处理和重跑安全性。
  6. 保留无关工作:保留无关的工作内容,并把跳过或不确定的单元暴露出来供审查。
  7. 保留有价值的工具:如果该工具的审查或复用价值会超出当前任务,就保留它,并附带可复现的调用方式和结果检查。
  8. 一次性任务也可成工具:如果构建工具是证明结果最经济的方式,一次性任务也可以获得一个工具;但不需要框架。
  9. 优先确定性执行:相比手工铺开,优先选择确定性的执行过程。若授权且有用,可以委派,但需共享一份稳定的配方、验证契约和写入边界;委派是可选的。

使用方式

该原则以判断准则的形式使用:在动手前先问“是否已有现成手段”“这项工作是否会重复”“结果是否需要独立核验”。若答案为是,则按上述步骤先复用、再构建最小工具、先验证代表性单元、再处理异常与重跑安全,最后在受控范围内应用。

适用场景

  • 重复性的转换或处理工作。
  • 难以人工可靠完成的检查。
  • 需要可复现、可独立核验结果的任务。
  • 需要把一次性验证结果沉淀为可复用手段的场合。

限制与边界

  • 不适用于已有命令或一次直接小改动即可完成的情况。
  • 新建文件不等于有用,必须能复用或能核验。
  • 不需要为此引入框架。
  • 委派是可选的,不是必须。

与其他原则的区别

  • 与 principle-reuse-before-building 的区别:后者关注在准备编写 helper、owner、script 或组件时,是否已有现成选项可以覆盖。
  • 与 principle-encode-lessons-in-structure 的区别:后者针对已验证的经验反复出现、需要持久防护的情况。
  • 与 principle-prove-it-works 的区别:后者关注声称某个结果可用时,运行最小的直接检查。

完成标准

工作及其检查可以借助已有或新建的杠杆复现;或者直接方法因总投入更低且置信度相当而被证明合理。