SuperAPI AI 工具集

nestjs-health-audit

通用与其它

查看项目

更新于 10-16 09:29

技能介绍

用途:对 NestJS 项目执行全面健康审计,按顺序执行模块化规则,输出带评分的审计报告,便于评估项目成熟度、技术风险与技术债。

主要能力:审计范围覆盖技术栈、架构、API 设计、数据层、测试、代码质量、文档与运维、CI/CD 八个部分;会计算分项分数(0-100)与加权总分,并生成执行摘要、评分卡、附加指标、质量指数、风险与机会、优先建议及证据索引。分析基于仓库证据,缺少证据时报告为 Unknown,不臆测。

使用方式:按规则顺序执行 references 下的规则文件,依次为 tool-installer、version-alignment(强制,nvm 配置失败即停止)、version-validator、test-coverage、repository-inventory、config-analysis、cicd-analysis、testing-analysis、code-quality、api-design-analysis、data-layer-analysis、documentation-analysis、report-generator。第 0 步须使用 nvm 对齐 Node.js 版本并安装全部依赖,包括根目录、packages 与 apps,示例命令为 npm install 或 yarn install 或 pnpm install,以及 find packages/ -name "package.json" -execdir npm install ; 与 find apps/ -name "package.json" -execdir npm install ;。最后生成纯文本报告,保存命令为 mkdir -p reports,输出到 ./reports/nestjs_audit.txt。

适用场景:需要评估 NestJS 单体或 monorepo 项目技术健康状况时使用;安全分析需另行运行独立的 Security Audit。

限制:明确不推荐 CODEOWNERS、SECURITY.md 及运维文档;缺少仓库证据的内容会标记 Unknown;具体评分权重、各规则细节与安装来源暂未提供。