模块化设计六原则 经典软件工程设计原则在 AI 协作场景下的现代化清单。 用作新模块设计、重构、代码审查时的对照表，不替代具体执行 skill。 触发场景 - 编写新模块、新服务、新接口 - 用户说"设计"、"拆分模块"、"评审"、"重构" - 、 、 、 命令在设计阶段 - 评估技术债时对照原则定位坏味道 --- 六原则速查表 | # | 原则 | 一句话 | 衡量指标 | 详细案例 | |---|------|--------|---------|---------| | 1 | 模块大小适中 | 单文件控制在职责边界内 | 行数/职责数 | 引用 size-check | | 2 | 减少调用深度 | 调用链尽量 ≤ 3 层 | 栈深度 | modularity.md#调用深度 | | 3 | 多扇入，少扇出 | 被复用 主动依赖 | 依赖数/被依赖数 | modularity.md#扇入扇出 | | 4 | 接口边界清晰 | 入参/出参/异常统一 | 统一响应包装 | modularity.md#边界清晰 | | 5 | 作用域内聚 | 改 A 不波及 B | 跨模块副作用 | 引用 refactor-safety | | 6 | 功能可预测 | 同输入→同输出 | 幂等/无副作用/可测 | predictability.md | --- 1. 模块大小适中 主要执行交给…