用途:该技能是 NestJS 应用的综合最佳实践指南,适用于编写、审查或重构 NestJS 代码时参考,覆盖新建模块/控制器/服务、实现认证授权、审查架构与安全问题、优化性能与数据库查询、构建微服务等场景。
主要能力:包含 40 条规则,分 10 类并按优先级排列。架构(CRITICAL,前缀 arch-)涵盖避免循环依赖、按功能而非技术层组织、模块导出导入、单一职责、仓储模式、事件驱动;依赖注入(CRITICAL,di-)涵盖避免服务定位器、接口隔离、里氏替换、构造器注入、作用域认知、接口注入令牌;错误处理(HIGH,error-)涵盖异常过滤器、HTTP 异常、异步错误;安全(HIGH,security-)涵盖 JWT 认证、class-validator 输入校验、守卫、输出净化防 XSS、限流;性能(HIGH,perf-)涵盖异步生命周期钩子、缓存、数据库查询优化、模块懒加载;测试(MEDIUM-HIGH,test-)涵盖 Testing 模块、Supertest E2E、模拟外部服务;数据库与 ORM(MEDIUM-HIGH,db-)涵盖事务、避免 N+1、迁移;API 设计(MEDIUM,api-)涵盖 DTO 序列化、拦截器、版本控制、管道;微服务(MEDIUM,micro-)涵盖消息与事件模式、健康检查、队列;DevOps 与部署(LOW-MEDIUM,devops-)涵盖配置模块、结构化日志、优雅关闭。
使用方式:按需阅读单条规则文件,如 rules/arch-avoid-circular-deps.md、rules/security-validate-all-input.md、rules/_sections.md;每条规则含原因说明、错误代码示例、正确代码示例及补充参考。完整合订版见仓库中的 AGENTS.md。
限制:资料未提供安装命令、收费方式、平台支持及具体效果数据。