python-design-modularity

用途：在 Python 代码库中设计模块边界、规划重构或评审架构时使用；也适用于依赖关系纠缠、上帝类、深层嵌套继承、组合与继承取舍、函数式核心/命令式外壳分离、跨模块重构规划，以及可读性与架构清晰度评审。不适用于纯性能优化、错误处理与可靠性模式、类型契约与协议设计，以及无维护周期的一次性脚本。主要能力：以可读性优先并保持显式模块契约；让控制流、数据流动与所有权边界可见；保持模块所有权与不变量显式；默认优先组合；在提升可测试性与关注点分离时应用函数式核心/命令式外壳；将行为变更与结构性重构分离，不在同一提交中混合。常见错误与限制：同时重构行为与结构会混淆两类风险，应先做其一；默认避免先用继承，除非“is-a”关系确实稳定；跨边界导入实现细节会形成隐性契约，应暴露显式公共 API 并保持内部私有；过早抽象易产生难撤销的错误抽象，宜等重复出现后识别真正接缝；把 I/O 与业务逻辑混在一起会增加测试难度与变更影响面，应把副作用推向边缘。这些建议是常见场景的偏好默认值而非通用规则；若与项目约束冲突或使结果变差，应提出更合适的替代方案并说明取舍与补偿控制（测试、可观测性、迁移、回滚）。调用时需按名称 python-design-modularity 告知用户。参考文件包括 references/design-rules.md、references/readability-and-complexity.md、references/module-boundaries.md、references/functional-core-shell.md、references/refactor-guidelines.md。安装命令与官方文本资料中暂未提供。