SuperAPI AI 工具集

codebase-design

编程与开发

查看项目

更新于 10-16 06:44

技能介绍

用途:在设计与重构代码时,用统一术语讨论模块接口,目标是让调用方获得杠杆、让维护者获得局部性、让所有人获得可测试性。

主要能力:提供术语表,包括模块、接口、实现、深度、接缝、适配器、杠杆、局部性,并强调不要用组件、服务、API、边界替代。给出深模块与浅模块的对比,设计接口时可自问:能否减少方法数、简化参数、隐藏更多复杂度。原则含:深度属于接口而非实现;删除测试;接口即测试面;一个适配器只是假设接缝,两个适配器才是真实接缝。可测试性建议:接受依赖而非创建依赖、返回结果而非产生副作用、缩小表面积。

使用方式:资料未给出具体安装或命令,仅提到深入内容可查看仓库内 .agents/skills/codebase-design/DEEPENING.md 与 .agents/skills/codebase-design/DESIGN-IT-TWICE.md(以仓库根目录为路径起点)。

适用场景:设计或改进模块接口、寻找加深机会、决定接缝位置、重构代码时。

限制:资料未说明平台、价格、收费或效果;被拒绝的框架中明确不采用按实现行数与接口行数之比衡量深度,也避免把边界一词用于 DDD 限界上下文。