setup-deep-modules
Installation
SKILL.md
配置深模块边界检查
把 codebase-design 中约定的模块接口变成静态检查。适用于已经存在明确业务模块或 package 边界的代码库;边界尚未确定时,先设计模块,不用工具替代架构决策。
流程
1. 识别真实边界
读取 workspace/包管理配置、语言自身的模块系统配置(TypeScript 的 tsconfig/package exports、Python 的 pyproject.toml、Go 的 go.mod、Java 的构建模块描述符等)、现有 import/包引用路径和测试布局。列出候选模块、公开入口、内部目录,以及允许的依赖方向。调用 codebase-design 核对这些边界是否代表真实接缝,而不是为了通过检查人为增加的层级。
完成条件: 每个受保护模块都有明确公开入口;无法解释的跨模块依赖已列为待决问题,不用宽泛例外掩盖。
2. 按语言生态选择检查器
仓库已有边界检查工具(dependency-cruiser、eslint import 规则、Nx、Turborepo、import-linter、ArchUnit、depguard 等)时扩展现有工具。没有时,按语言选默认方案: