SuperAPI AI 工具集

principle-minimize-reader-load

编程与开发

查看项目

更新于 11-06 21:01

技能介绍

该技能的核心是把可维护性定义为阅读者理解代码所需付出的工作,并用两个相互独立的维度来衡量:需要追踪的层数,即问题与答案之间的间接层级;以及需要持有的状态,即阅读者必须在脑中记住的隐藏或可变上下文。代码行数、圈复杂度以及“整洁架构”都只是代理指标,真正重要的是阅读者负担。两个维度需要同时防护:一个包含 50 个全局变量的扁平文件,可能与六层适配器堆栈一样难以推理;这也是“守护上下文窗口”在人类阅读者身上的对应物,因为阅读者的工作记忆同样有限。

在层数方面,技能要求折叠那些成本高于收益的层:只有一个调用者的包装器、没有第二种实现的适配器、从未真正需要的推测性间接。例外情况是位于真实 I/O 或非确定性边界上的端口,例如数据存储、缓存、队列、文件系统、外部服务、时钟、随机数、ID 生成,即使只有一个适配器也应保留接缝,因为测试会替换它;纯内部逻辑上的端口则应折叠。相邻层必须真正改变抽象,如果一层只是重复相同的方法和参数,它只增加阅读负担而不提供压缩,应予以折叠。接口也应具备压缩性:宽泛却几乎不隐藏复杂度的接口,会让阅读者既要学表面又要学实现;应优先选择能隐藏有意义决策的边界。

在状态方面,技能要求缩小状态作用域:优先纯函数而非修改操作,优先局部变量而非字段,优先字段而非模块状态,优先模块状态而非全局变量;能用推导解决就不要做同步。不变量应在边界处命名一次,而不是在每个使用处重复,这样阅读者只需学习一次。在新增一层或一份状态之前,应先问:它是否至少等量地减少了别处的阅读者负担?

使用方式上,该技能适用于审查或调整难以追踪的代码时;按照说明,在遵循本技能前,每个会话应先阅读一次宿主适配器,它会把上游 Cursor 特定的工具、模型、路径和权限指令映射到宿主,并设定权限边界。最终检验标准是:新读者能否在 30 秒内回答“X 从哪来”和“什么能改变 X”;如果不能,就削减层数或削减状态。关于具体平台支持、安装方式、收费与价格,资料暂未提供。