Agent Skills
返回列表
💻

NestJS 工程专家

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/shipshitdev-skills-nestjs-expert。

技能介绍

你在 NestJS 里常踩的坑

生产里的 NestJS 服务一旦堆上 MongoDB/Mongoose、全局校验和鉴权,就容易出现「控制器里写业务」「读查询不用 .lean()」「process.env 散落各处」这类问题。它们不体现在教程示例里,却会在 Code Review 和压测阶段集中暴露。

技能如何约束你的实现

这份约定以 TypeScript 严格模式 为底线,要求功能按 自包含 Module 拆分:跨模块只走导出的 Provider,尽量避免 forwardRef 掩盖循环依赖。

  • 控制器:只做路由与入参绑定;@Body() / @Query() / @Param() 一律用 DTO;用自定义 @CurrentUser(),不用 @Req() 掏 user。
  • 校验:在 main.ts 挂全局 ValidationPipe,让非法入参在边界被挡住。
  • Mongoose:读路径默认 .lean().exec();服务层引用用 Types.ObjectId;用户数据 软删除(deletedAt),不做硬删。
  • 配置与观测:环境变量只在 Config 模块经 ConfigService 读取;日志用 new Logger(ClassName.name),不用 console.log。
  • 性能:为 find / sort 涉及的字段建索引,多字段查询考虑复合索引;大文档用 select() 投影;昂贵读可走 @nestjs/cache-manager。
  • 测试:用 Test.createTestingModule,外部依赖一律 Mock。

文末对照表把「业务逻辑进 Controller」「到处 any」等反模式与正确做法并排,方便在改代码时快速自检。

适用边界

它覆盖典型 REST + MongoDB 单体/模块化后端惯例,不替代 BullMQ 队列设计、Mongo 迁移脚本或全局错误策略的专项技能;那些场景应结合文档里列出的关联技能单独处理。

使用场景

  • 新接口要接 JWT 鉴权,需统一 Guard、@CurrentUser() 与 DTO 校验,避免在控制器里读 req.user
  • Mongo 列表接口变慢,需按 find/sort 字段补索引并在读查询上统一 .lean().exec()
  • 多 Module 互相引用触发循环依赖,需按导出 Provider 拆边界而非到处 forwardRef
  • Code Review 发现控制器直连 Mongoose,需把业务与持久化迁回 Service 并补齐测试 Module Mock

适合人员

  • 用 NestJS + Mongoose 交付 REST 的后端工程师,希望在团队内统一 Module 边界与 DI 写法
  • 负责 API 性能的后端,需要在 Mongoose 读路径上落实 lean、索引与 select 投影规范
  • 带 Nest 代码库的 Tech Lead,要在 PR 中系统性揪出 any、硬删与 process.env 直读
  • 刚接入全局 ValidationPipe 的项目成员,需要把入参 DTO 与异常过滤器职责划清楚