SuperAPI AI 工具集

codebase-design

编程与开发

查看项目

更新于 10-16 03:16

技能介绍

用途:这是一套用于设计“深模块”的共享词汇,目标是在清晰的接缝处用小型接口封装大量行为,让调用方获得杠杆、维护者获得局部性,并保持可测试性。适用于设计或改进模块接口、寻找深化机会、决定接缝位置等场景。

主要能力:提供一致的术语表,包括模块、接口、实现、深度、接缝、适配器、杠杆、局部性;区分深模块与浅模块;给出设计接口时的自问(能否减少方法数、简化参数、隐藏更多复杂度);提出原则,如深度是接口属性而非实现属性、删除测试、接口即测试面、一个适配器只是假想接缝而两个才是真实接缝;并给出可测试性设计建议(在真实接缝处把依赖作为参数传入、优先返回结果而非副作用、保持接口面小)。

使用方式:在澄清设计决策时使用这套词汇。应用时报告推荐的模块、接口与接缝,说明结果如何改善深度、杠杆、局部性或可测试性,并指出重要权衡或未解决的证据。若该技能仅用于支撑其他产物,则把分析并入该产物而非单独报告。

适用场景:模块接口设计或评审、寻找深化机会、决定接缝位置、评估可测试性。

限制:资料未提供具体安装命令、平台、收费或价格信息;深化集群与探索替代接口的细节见 references/DEEPENING.md 与 references/DESIGN-IT-TWICE.md,本技能源自 mattpocock/skills 的分支。