SuperAPI AI 工具集

module-boundaries

通用与其它

查看项目

更新于 10-15 22:19

技能介绍

用途:诊断并修复超出单一职责、或与其他模块过度纠缠的模块,目标是一个模块只负责一个逻辑领域,只暴露调用方需要的内容,能在不了解整个系统的前提下阅读、测试和修改。

触发场景:单文件或模块超过约300行且处理多种关注点;模块间存在循环导入;一个模块从代码库中许多不相关部分导入;改动一个模块经常破坏无关模块;utils、helpers、common、shared 变成堆放场;公开与内部使用没有清晰区分;多模块因无明确归属而重复逻辑。

主要步骤:一,映射现状,收集导入图(高扇入、高扇出、循环)、为每个模块写一句话职责(出现多个“and”说明职责过多)、定位耦合热点;二,诊断耦合类型,区分 god module、堆放场、循环依赖、内部细节泄露、跨层导入、过早合并,并对应不同修法;三,设计新边界,以领域边界而非文件大小为依据,可用纵向功能模块、精简共享内核、基础设施模块等形态,每个模块只留一个对外入口(如 index.ts、init.py、包级导出);四,破除循环依赖,可提取共享类型到中立模块、反转依赖、或在确有内聚时合并,不要用第三个“胶水”模块掩盖耦合;五,输出重构结构,含前后目录树、各模块公开接口和迁移顺序(先建壳、先移类型、由外向内改导入、最后删旧路径);六,验证并标注,输出边界健康摘要,说明模糊归属、刻意不导出的内容及无明确归属的逻辑。

语言细节:TypeScript/JavaScript 可用 ESLint no-restricted-imports、tsconfig paths、package.json exports;Python 可用 all、相对导入、src/ 布局;Java 可用包私有与 module-info.java;Go 以包为边界,internal/ 由编译器强制。

限制:资料未提供实现工具、安装命令、收费或效果数据,暂未提供。