SuperAPI AI 工具集

principle-build-the-lever

通用与其它

查看项目

更新于 10-16 01:28

技能介绍

用途:这是一条适用于各类非琐碎工作的原则,不限于批量任务,也包括编辑、迁移、分析和检查。核心做法是构建“杠杆”——即真正执行或证明该工作的工具,而不是手工完成。

主要能力与理由:codemod、生成器或脚本每次都以相同方式完成工作,且可免费重跑。工具是一个可被审查者阅读并重跑以核验工作的产物;手工改动只能靠重做来再次验证。确定性脚本把“相信我”变成“运行这个”。

使用方式:默认构建杠杆,仅当任务确实琐碎(一眼可见的几处明显编辑)时才跳过。先手工完成第一个单元以摸清配方,再构建工具;通过在该单元上重跑并与手工版本做 diff 来证明其正确。让杠杆可安全重跑。编辑用 codemod 或脚本,重复文件用生成器,分析用 dump-to-sqlite 查询,验证用可重跑检查。

确定性杠杆优于扇出:若工具能一次处理所有单元,就自己运行,不要把脚本能做的事分派给代理手工套用。若确实要分派给子代理,把杠杆写成它们都读取的技能:配方、验证契约和禁止触碰的边界放在同一产物中,并置于子代理写入范围之外,防止其悄悄修改契约。

判定标准:应用该原则会产生一个文件。若引用了它而 diff 中没有 codemod、脚本、生成器或代理技能,则说明并未应用。当工作生命周期超过本次会话时,提交该杠杆。门槛是琐碎性而非重复性:一次性任务若杠杆正是让工作可检查的手段,也值得构建。按 Laziness Protocol,构建能完成或证明任务的最小脚本,绝不构建框架。

限制与边界:该原则区别于“将经验编码进结构”(后者把反复出现的指令变成持久护栏),它关注的是眼前工作的吞吐量与可审查性;若要脚本化验证本身,另见 Prove It Works。资料未提供具体安装命令、代码示例或平台信息。