SuperAPI AI 工具集

codebase-design

设计与创作

查看项目

更新于 10-15 20:21

技能介绍

用途:为代码设计与重构提供统一语言和原则,目标是让调用方获得杠杆、维护者获得局部性、所有人获得可测试性。

主要能力:定义并区分 Module、Interface、Implementation、Depth、Seam、Adapter、Leverage、Locality 等术语,强调不要用 component、service、API、boundary 替代。给出深模块与浅模块的对比:深模块是小接口加大量实现,浅模块是大接口加薄实现,应避免。设计接口时追问:能否减少方法数、简化参数、隐藏更多复杂度。

原则:深度是接口属性而非实现属性;删除测试——删掉模块后复杂度消失说明是直通,复杂度在 N 个调用方重现说明有价值;接口即测试面;一个适配器只是假设接缝,两个适配器才是真实接缝。可测试性建议:接受依赖而非创建依赖,返回结果而非产生副作用,缩小接口面积。

用法:在设计与重构代码时使用这套词汇和原则;深化模块集群见 DEEPENING.md,探索替代接口见 DESIGN-IT-TWICE.md。

限制:资料未提供安装命令、平台、收费或价格信息;未提供具体代码示例之外的完整实现细节。