用途:这套资料提供设计“深模块”的共享词汇与原则,用于在任何代码被设计或重构时统一语言。目标是让调用方获得杠杆、让维护者获得局部性、让所有人获得可测试性。
主要能力:给出术语表,包括模块、接口、实现、深度、接缝、适配器、杠杆、局部性,强调术语应严格使用,不要用 component、service、API、boundary 替代。区分深模块(小接口+大量实现)与浅模块(大接口+少量实现,应避免),并给出设计接口时的自问:能否减少方法数量、简化参数、隐藏更多复杂度。
核心原则:深度是接口的属性而非实现;删除测试(删除该模块后复杂度若消失则是直通,若在 N 个调用方处重现则值得保留);接口即测试面;仅当确有变化时才引入接缝。设计可测试性时建议接受依赖而非创建依赖、返回结果而非产生副作用、保持小表面积。
关系:一个模块恰有一个接口,深度是模块相对接口的属性,接缝是接口所在之处,适配器位于接缝满足接口,深度为调用方产生杠杆、为维护者产生局部性。
限制:资料未提供具体安装命令、收费方式、支持平台或完整使用步骤;仅部分内容指向 DEEPENING.md 与 DESIGN-IT-TWICE.md 进一步阅读。