用途:对 NestJS 代码库进行深入的微观代码质量审计,聚焦单个函数、类与测试文件的实现质量,以及架构、测试与编码标准的符合度。
主要能力:支持测试质量分析(命名约定、断言质量、Mock 设置与清理、Arrange-Act-Assert 结构、集成测试数据库处理)、架构合规分析(分层边界、依赖注入、模块组织、仓储与服务组合)、代码标准分析(TypeScript 严格模式、命名约定、装饰器用法)、DTO 验证分析与错误处理分析。标准来源为 agent-rules/rules/nestjs/ 下的文件(本地存在则读取,否则从 GitHub raw 获取),涵盖 dto-validation、service-patterns、controller-patterns、repository-patterns、testing-unit、testing-integration、error-handling、module-structure、typescript。
使用方式:通过 somnio run 按 Rule Execution Order 依次执行各引用文件(testing-quality、architecture-compliance、code-standards、dto-validation、error-handling、best-practices-generator),也可在 Claude Code 等兼容代理中以子代理编排路径执行,orchestrator 按波次并行派发子代理,校验产出的 artifact 后推进,最后仅由 report-writer 写入最终报告。报告文件名固定为 reports/<YYYY-MM-DD>-<project>-nestjs-best-practices.md,其中项目名由 origin 远程 URL 派生并 slug 化,无远程时用仓库目录名。报告末尾必须包含 Report Metadata 表,Generated by 行保持模板原文。
限制:仅做代码质量分析而非基础设施分析;缺失证据须标注 Unknown,不允许假设或编造;通过 somnio run 运行时须使用 CLI 传入的报告路径,不得重新计算,否则步骤会失败。