SuperAPI AI 工具集

principle-build-the-lever

通用与其它

查看项目

更新于 10-16 07:07

技能介绍

Build the Lever(构建杠杆)是一条适用于任何非琐碎工作的原则,不限于批量任务,也包括编辑、迁移、分析与检查。

核心主张:当工作并非琐碎时,构建能完成该工作的工具,而不是手工去做。

为什么:有两个收益。吞吐量——codemod、生成器或脚本每次以相同方式完成工作,并且可以免费重跑。可信度——工具是一个产物,审查者可以阅读并重跑以检查工作。手工完成的变更只能通过重做来重新验证。确定性脚本把“相信我”变成“运行这个”。

模式:默认构建杠杆。只有当任务琐碎、只是几处一眼可见的明显编辑时才跳过。

做法:先手工完成第一个单元以学习配方,然后构建工具。通过在该单元上重跑工具并与手工版本做 diff 来证明它。让杠杆可以安全重跑。

形式:编辑用 codemod 或脚本,重复文件用生成器,分析用 dump-to-sqlite 查询,验证用可重跑的检查。

确定性杠杆优于扇出。如果工具能一次处理每个单元,就自己运行它。不要把委派扇出给子代理去手工应用脚本能做的事。

当你把工作扇出给子代理时,把杠杆写成一个它们都会阅读的技能:配方、验证契约和禁改围栏放在同一个产物中。把它放在委派者的写入范围之外,这样它们就不能悄悄修改契约。

应用这条原则会产生一个文件。如果你引用了它,而 diff 中没有 codemod、脚本、生成器或委派技能,那你就没有应用它。

当工作比当前会话活得更久时,提交这个杠杆。

平衡:门槛是琐碎性,不是重复性。一次性任务在杠杆使其可检查时仍然值得构建杠杆。按照 Laziness Protocol,构建能完成或证明工作的最小脚本,绝不要构建框架。

与 Encode Lessons in Structure 的区别:后者把重复出现的指令变成持久护栏。本条原则关注的是眼前工作的吞吐量与可审查性。关于把验证本身脚本化,参见 Prove It Works。