SuperAPI AI 工具集

principle-build-the-lever

通用与其它

查看项目

更新于 10-16 17:27

技能介绍

用途

本技能是一条通用工作原则,适用于任何“非琐碎”的工作,而不只是批量工作。所谓非琐碎,指的是那些手动逐项完成既费时又难以复核的任务,例如:编辑、迁移、分析、检查。当工作不是琐碎的(不是一两处一眼就能看清的修改)时,应当构建能完成该工作的工具,而不是手工去做。

主要能力

该原则提供的不是某个具体软件功能,而是一种工作方式与判断标准:

  • 构建杠杆:为编辑写 codemod 或脚本,为重复性文件写生成器,为分析写 dump-to-sqlite 查询,为验证写可重跑的检查。
  • 确定性:一个 codemod、生成器或脚本每次都以相同方式完成工作,并可免费重跑。
  • 可审查性:工具是一个审查者可以阅读和重跑的产物,用于检查工作结果;手工完成的修改只能靠重做来重新验证。确定性脚本把“相信我”变成“运行这个”。
  • 先手工再自动化:先手工做第一个单元以学习配方,然后构建工具。通过在该单元上重跑工具、并与手工版本做 diff 来证明工具正确。
  • 杠杆安全可重跑:要让杠杆可以安全地重复运行。
  • 确定性杠杆优于扇出:如果工具能一次处理每个单元,就自己运行它。不要把工作扇出给委派者去手工套用脚本能做的事。
  • 分派时写成技能:当把工作扇出给子智能体时,把杠杆写成一个它们都会阅读的技能——配方、验证契约和禁止触碰的边界都放在同一个产物里。把它放在委派者的写入范围之外,这样它们就无法悄悄修改契约。

使用方式

应用该原则应产出文件。如果你引用它,但 diff 里没有 codemod、脚本、生成器或委派技能,那就说明你没有应用它。当工作的生命周期超过当前会话时,提交该杠杆。

判断标准是“琐碎与否”,而不是“是否重复”。即使是只做一次的工作,只要杠杆能让工作变得可检查,也值得构建杠杆。依据 Laziness Protocol,构建能完成或证明任务的最小脚本,绝不要构建框架。

适用场景

  • 需要确定性重复执行的编辑、迁移、分析与检查工作。
  • 需要让审查者能够复跑验证、而非只能重做的工作。
  • 需要将同一套配方分派给多个子智能体执行的工作。

限制

  • 当任务琐碎(一两处显而易见的修改)时,跳过构建杠杆。
  • 该原则与“Encode Lessons in Structure”不同,后者是把反复出现的指令变成持久的护栏;本原则关注的是眼前工作的吞吐量与可审查性。
  • 关于把验证本身脚本化,参见 Prove It Works。

补充说明

资料中未提供该技能的收费、价格、平台支持范围或具体使用步骤等更多信息。