SuperAPI AI 工具集

principle-build-the-lever

智能体与模型

查看项目

更新于 10-16 08:31

技能介绍

Build the Lever 是一条面向工程与智能体工作流的原则,主张“非琐碎的工作,先造工具,再动手”。

适用用途 它适用于任何非平凡的工作,而不只是批量工作:代码编辑、数据迁移、分析、检查等。核心判断标准是任务是否琐碎,而不是是否重复。只要工具能让工作变得可检查,即使一次性任务也可能值得造杠杆。

主要能力 构建 codemod、生成器或脚本,可以让同一项工作每次都以相同方式执行,并且可以免费重跑。手工完成的修改只能通过重做来重新验证;确定性脚本把“相信我”变成“运行这个”。工具是一个可被审查者阅读并重跑的单一产物。

使用方式 默认先构建杠杆。只有任务确实琐碎、只有几处一眼可见的编辑时才跳过。具体做法是:先手工完成第一个单元,学习配方,然后构建工具;把工具在该单元上重跑,并与手工版本做 diff 来验证;让杠杆可以安全重跑。不同类型的工作对应不同杠杆:编辑用 codemod 或脚本,重复文件用生成器,分析用 dump-to-sqlite 查询,验证用可重跑的检查。

与任务分发的关系 确定性杠杆优于任务分发。如果工具能一遍处理所有单元,就自己运行,不要把脚本能做的事分发给子代理去手工应用。当必须把工作分发给子代理时,应把杠杆写成它们共同读取的技能,把配方、验证契约和不可触碰的边界放在同一个产物中,并把它放在代理的写入范围之外,防止它们悄悄修改契约。

验证与提交 应用该原则的产物是一个文件。如果引用了它,但 diff 中没有 codemod、脚本、生成器或代理技能,就等于没有应用。当工作持续时间超过当前会话时,应提交这个杠杆。

限制 构建的应是能完成或证明任务的最小脚本,而不是框架。该原则与“Encode Lessons in Structure”不同:后者把重复指令变成持久护栏,而这条原则关注眼前工作的吞吐量与可审查性。若需要脚本化验证本身,则应参考“Prove It Works”。