codebase-design：深模块设计

codebase-design：深模块设计

codebase-design 是模型触发的设计纪律：提供一套关于「深模块」的共享词汇与方法——用很小的接口藏住大量行为，放在干净的接缝上，且能透过接口测试。它回答的是「模块怎么切才优雅」。

深模块设计的共用词典：小接口、大能力、干净接缝、可测。

它解决什么问题

AI 加速了写码也加速了熵增，模块常被切成「浅模块」——接口复杂却没藏住多少行为，导致改动到处扩散。

何时使用

• 设计新模块，想让它接口窄、能力强
• 审视现有模块是不是太「浅」
• 需要一套能和代理讨论模块边界的通用词汇

核心工作流

• 识别模块该藏住的核心行为
• 设计尽量小的公共接口
• 把模块放在干净的接缝上
• 确保行为能透过接口被测试

关键原则与反模式

• 最好的模块是深的：大量功能藏在简单接口之后
• 接口越小，改动波及面越小
• 模块必须放在干净接缝上，且可透过接口测试
• 与 improve-codebase-architecture 同源，一个管设计、一个管体检

与其他技能的配合

codebase-design 给 implement 和 tdd 提供「在哪切、怎么测」的方法论；它和 improve-codebase-architecture 一起构成设计投资的两端。

相关技能：

• improve-codebase-architecture：抢救大泥球
• implement：按规格构建
• tdd：测试驱动开发
• prototype：一次性原型

常见问题

什么是深模块？

用很小的接口藏住大量行为的模块，改动时波及面小、易复用。对应地，浅模块接口复杂却没藏住多少能力。

它和代码架构体检有什么关系？

codebase-design 管「怎么设计才对」，improve-codebase-architecture 管「现有代码哪里需要深化」，二者互补。

返回章节：工程技能完全指南