用途：在不破坏项目既有边界、命名和技术选型的前提下，交付可维护、可验证且安全的 NestJS 改动，适用于新增功能、修复、诊断、评审、安全加固和结构调整。
主要能力：提供模块与依赖组织规则（Controller 做协议适配、Provider 承担业务用例、持久化负责数据访问，模块只导出外部需要的 Provider，优先单向依赖）；DTO 与模型规则（HTTP 输入用带 class-validator 的 class，创建/更新/查询/响应模型分离，Entity 只表达持久化，bigint 标识在 API 与 TypeScript 中保持 string）；HTTP 契约与异常规则（全局前缀和版本只配置一次，PUT 完整替换、PATCH 部分更新，异常保留正确状态码，未知异常记录 request ID 且不泄露堆栈、SQL 或密钥）；数据与安全规则（多表写入、状态变更与审计使用事务，缓存失效、消息和 SSE 通知在事务提交后执行，敏感数据按敏感处理，权限标识沿用既有命名）；注释规则（解释为什么、业务不变量、安全决策与边界条件，导出契约用 JSDoc/TSDoc）。
使用方式：先检查仓库而非猜测技术栈，读取 package.json、锁文件、nest-cli.json、TypeScript 与 lint 配置，检查 main.ts、根模块、相关功能模块、DTO、实体或模型、测试和数据库迁移，查看 Git 状态并保留用户已有改动；明确任务性质后先确定对外契约和模块边界，再实现最小且完整的改动；按需读取 references/architecture.md、references/rest-dto-validation.md、references/typeorm-transactions.md、references/auth-security.md、references/testing-comments.md。
适用场景：NestJS 模块、控制器、服务、DTO、实体、事务、认证授权与安全加固等后端工作。
限制：不强制 REST、TypeORM、JWT、MySQL、Redis 或 Swagger，仅在仓库已采用或用户明确要求时使用；不追求标准目录批量改名；用户要求、仓库内 AGENTS.md 与项目配置优先于示例；不通过放宽类型、关闭规则、删除断言或弱化测试掩盖失败。