SuperAPI AI 工具集

sonarqube-audit

安全与审计

查看项目

更新于 10-15 22:12

技能介绍

用途:按 SonarQube 规则审计项目全部可审计文本文件,生成 Markdown 健康报告,输出到项目根目录的 sonarqube-reports/ 文件夹,报告语言为 pt-BR。执行期间终端不输出中间内容,仅最后输出生成的文件名。

主要能力:报告基于本次执行实际核验的代码状态,禁止沿用旧报告的数字或结论;旧报告仅作为复检清单和覆盖度保障,问题状态标记为 ✅ 已修复、❌ 仍存在、🆕 新增、➖ 不适用。每次执行重新分析 100% 可审计文件,不做抽样;可审计文件为除 .gitignore 排除项及第三方依赖/构建产物(如 node_modules/、vendor/、dist/、build/、target/、.min.js、jquery.js)外的全部文本文件。报告须严格遵循 _shared/report-template.md 模板,各章节及标题图标为必填,空章节写“Nenhuma violação encontrada nesta fase.”。

使用方式:仅在用户明确要求 SonarQube 审计时触发,如“audit sonarqube”“scan sonarqube”“relatório sonarqube”“verificar violações”“revisar compliance”等;意图不明确时须先确认再执行。执行流程包括:第 0 步运行确定性扫描器 node .agents/skills/sonarqube-audit/scanners/scan.mjs <project_root> /tmp/opencode,生成 /tmp/opencode/findings.json;第 1 步依据 .gitignore 建立文件清单;第 1.5 步复检历史报告;第 2 步按类别分类;第 3 步按类别并行子代理分析;第 4 步按严重度与修复难度分 5 个阶段;第 5 步生成报告,文件名格式为 sonarqube-reports/<项目目录名>_<AAAA-MM-DDTHHMMSS>.md。

限制:需 node >= 18 与 ast-grep(npm i -g @ast-grep/cli,或 cargo install ast-grep / brew install ast-grep);缺少 ast-grep 时仅运行确定性层并给出 WARNING。扫描器覆盖 S2068、S1313、S5131、S2115、S106、S1148、S1128、S1135、S2589、S1186、S2386、S6676、S4830、S2245、S3330、S5122、S2095、S1442 等规则,其余如 S3776、S1161、S1066、S1452、S2259、S1854 及设计/架构类规则由 LLM 子代理分析。项目可能无 .git 目录,不能依赖 git ls-files。