SuperAPI AI 工具集

codebase-design

编程与开发

查看项目

更新于 10-16 07:26

技能介绍

用途:这套词汇用于设计或改进模块接口、寻找加深机会、决定接缝位置,并让代码更易测试、更利于 AI 导航;也可供其他技能复用的深模块术语。

主要能力与原则:强调模块是任意具有接口和实现的东西;接口不仅包含类型签名,还包含不变量、顺序约束、错误模式、必要配置和性能特征;深度是接口属性,即调用者或测试每学习一单位接口能行使多少行为。设计接口时自问能否减少方法数、简化参数、把更多复杂度藏到内部。区分深模块(小接口+大量实现)与浅模块(大接口+很少实现,避免)。使用删除测试判断模块是否只是直通。

接缝与适配器:接缝是可改变行为而无需就地编辑的位置;适配器是接缝处满足接口的具体事物。一个适配器意味着假设的接缝,两个适配器才是真实的接缝,不应在无实际变化处引入接缝。

可测试性:接受依赖而非创建依赖;返回结果而非产生副作用;保持小表面积,方法越少测试越少,参数越少测试搭建越简单。接口就是测试表面,调用者与测试穿过同一接缝。

限制与来源:资料注明源自 mattpocock/skills(MIT)。术语使用需严格一致,避免用 component、service、API、boundary 替代。其他具体用法、安装步骤或平台信息暂未提供。