setup-ts-deep-modules
Installation
SKILL.md
配置 TypeScript 深模块边界
把 codebase-design 中约定的模块接口变成静态检查。适用于已经存在明确业务模块或 package 边界的 TypeScript 仓库;边界尚未确定时,先设计模块,不用工具替代架构决策。
本 skill 附带 dependency-cruiser.config.cjs 作为起点。它假设每个模块的根文件是公开入口、子目录是内部实现;实际仓库不符合时,根据其结构修改规则和说明,不强行迁移目录。
过程
1. 识别真实边界
读取 workspace 配置、TypeScript 配置、package exports、现有 import 路径和测试布局。列出候选模块、公开入口、内部目录,以及允许的依赖方向。调用 codebase-design 核对这些边界是否代表真实接缝,而不是为了通过 lint 人为增加的层级。
完成条件: 每个受保护模块都有明确公开入口;无法解释的跨模块依赖已列为待决问题,不用宽泛例外掩盖。
2. 选择并配置检查器
仓库已有 dependency-cruiser、eslint import 规则、Nx、Turborepo 或其他边界检查时扩展现有工具。没有时,默认使用 dependency-cruiser,并通过现有包管理器加入开发依赖。
按实际结构配置: