用途:该技能用于在设计与重构 NestJS 模块、依赖注入、异常过滤器、DTO 校验以及集成 Drizzle ORM 时提供实践规范,也适用于代码审查、识别反模式或新人熟悉 NestJS 代码库。
主要能力:一是模块化架构,要求每个领域功能独立成 @Module(),只导出其他模块需要的内容,内部提供者保持私有,避免循环依赖,优先重构而非 forwardRef(),横切关注点放入 SharedModule。二是依赖注入,按场景选择作用域:DEFAULT 为单例,适用于无状态服务与仓储;REQUEST 为每请求实例,适用于请求级数据;TRANSIENT 为每次注入新实例,适用于有状态工具;默认使用 DEFAULT,统一采用构造器注入,自定义提供者用 useClass、useValue、useFactory 或 useExisting 注册。三是请求生命周期,顺序为中间件→守卫→拦截器前→管道→路由处理→拦截器后→异常过滤器,各层职责分别为跨切面、鉴权、响应转换、校验与错误格式化。四是错误处理,扩展 HttpException、创建领域异常类、实现全局 ExceptionFilter,避免静默吞掉异常。五是校验,全局启用 ValidationPipe 并设置 transform 与 whitelist,DTO 属性加 class-validator 装饰器,用 class-transformer 做类型转换,Create、Update、Response 分设 DTO。六是数据库模式,将 Drizzle 客户端封装为可注入提供者,采用仓储模式,按领域模块拆分 schema,多步操作用事务,控制器不直接访问数据库。
使用方式:给出示例工作流,包括创建模块、定义 DTO、在服务中处理错误,并用 grep -r "ProductModule" src/app.module.ts 检查模块注册、用 npx jest --testPathPattern="product" 运行端到端测试。
限制与注意:不要无理由混用作用域,REQUEST 作用域会级联到所有依赖方;控制器不得直接访问数据库;避免 forwardRef();不要跳过 ValidationPipe;不要硬编码密钥,应使用 @nestjs/config 与环境变量;保持模块聚焦,避免“上帝模块”。参考文件包括 references/architecture.md 及各项执行规则与 assets/templates/ 组件模板。具体收费、价格、平台支持等信息暂未提供。