SuperAPI AI 工具集

nestjs-dev-guidelines

编程与开发

查看项目

更新于 10-16 06:50

技能介绍

用途:为已使用 NestJS 原语(@Module、控制器、provider/service、守卫、管道、DTO)的仓库,或明确要求设计 NestJS 方案的任务,提供生产级后端规范,用于写代码、评审 PR 与重构决策。对纯 Express/Fastify/Hono/Koa 项目仅适用跨领域部分(校验、契约、授权、数据库设计、测试、可观测性),不强行套用 Nest 专有 API 与目录结构。

主要能力:给出执行纪律(先思考、声明假设、核实易变事实、先搜索复用、最小改动、外科式编辑、定义成功标准);不可妥协项,如控制器不含业务逻辑、所有外部输入经 DTO 与全局 ValidationPipe(whitelist、forbidNonWhitelisted、transform)、不信任客户端并做归属校验、一个模块独占其数据表、数据库 snake_case 与代码 camelCase、统一响应契约、列表必须分页、密钥仅来自环境变量并在启动时用 Zod 校验、结构化脱敏日志、按边界测试、多租户身份由服务端派生并分层强制。

使用方式:动手前先读 references/00-execution-discipline.md 与不可妥协项;文件放置、模块边界与重构用决策树;深入主题打开对应 references/NN-<topic>.md;评审 PR 走 references/29-code-review-checklist.md 及相关主题文件。

适用场景:新功能模块设计、代码评审、重构、API 与数据库规范、认证授权、日志与可观测性、测试策略、多租户隔离、Webhook、文件上传、N+1 消除等。

限制:资料未提供具体安装命令、版本矩阵、收费与价格信息;易变事实(版本、包 API、模型 ID、CLI 参数)需按官方文档与仓库核实,不凭记忆推荐。