用途:对 NestJS 项目执行全面的健康审计,覆盖技术栈、架构、API 设计、数据层、测试、代码质量、CI/CD、文档与运维,以及 AI 工具链(harness)采用情况,最终产出带评分的 Markdown 报告。
主要能力:以 14 条模块化规则顺序执行分析,每条规则可独立运行并输出结果供最终报告整合。支持会话内多子代理分层架构(cheap/mid/frontier 三层),由 agents/orchestrator.md 协调;CLI 路径(somnio run)则按规则执行顺序单模型运行。分析基于仓库证据,缺失证据时标注 Unknown,不臆测。
使用方式:先执行强制步骤 0,读取并遵循 references/tool-installer.md、version-alignment.md、version-validator.md、test-coverage.md,使用 nvm 对齐 Node.js 版本并安装根、packages、apps 全部依赖,生成测试覆盖率;随后按波次执行仓库清单、配置分析、CI/CD、测试、代码质量、API 设计、数据层、文档、AI harness 分析,最后由 report-generator.md 生成报告并导出到 ./reports/<YYYY-MM-DD>-<project>-nestjs-health-audit.md。
适用场景:需要评估 NestJS 后端项目技术健康度、技术债与成熟度,并希望获得结构化评分报告时使用。
限制:仅聚焦技术层面,不提供治理类建议(如 CODEOWNERS、SECURITY.md)或运维文档建议;安全分析需另行运行 /somnio:security-audit;nvm 配置失败会中止执行;具体评分权重与报告细节以资料所述规则为准,其余未提供。