Agent Skills
返回列表
💻

SonarQube 质量门禁解释器

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_3c6cb52e/sonarqube-quality-gate-explainer。

技能介绍

它解决什么问题

CI 流水线跑完 SonarQube 分析后，你可能只看到一个红色的「Quality Gate failed」，却不知道门禁到底卡在哪：是覆盖率跌破阈值？半路冒出几个新 Bug？还是有安全热点等待人工确认？手动排查意味着在 SonarQube 界面的一堆 Measures 和 Issues 之间来回切换，逐项比对上一次分析结果，才能拼出失败的完整图景。

这个技能做什么

  • 拉取项目最新一次 SonarQube 分析结果，与历史数据自动比对
  • 把失败的门禁条件逐条翻译成大白话，比如「新增 3 个 Bug，导致 New Code 上的 Bug 密度超标」
  • 覆盖三类最常见的失败诱因：覆盖率下降、新增 Bug、安全热点
  • 每条解释都附带指向 SonarQube 具体 Issue 的链接，点进去即可定位到行级问题

同时支持自托管的 SonarQube Server 与云端的 SonarCloud，两种部署形态一视同仁。

适用边界与注意点

  • 只诊断，不动手：产出是解释和链接，不会自动改代码，更不会替你把门禁强行放绿，修不修、怎么修仍是你的事
  • 它解释的是「最近一次分析」的结果，若项目分析频率很低，定位到的可能已是过时状态
  • 使用环境需保证 git 在 PATH 中可用；相关构建链路依赖 Java 17 与 npm，测试步骤可按需跳过

使用场景

  • CI 里 SonarQube 质量门禁失败，流水线红掉，需要马上知道是覆盖率、Bug 还是安全热点哪项超标。
  • 门禁失败后报告里满是指标和 Issue，想让人把具体是哪几个问题导致的讲清楚并给出链接。
  • Review 本次提交时，想确认是否引入了新的 Bug 或安全热点，定位到具体代码行。
  • 做质量复盘时，需要汇总近期几次门禁失败的原因，区分新代码和旧代码上的问题。

适合人员

  • 后端 Java 工程师：CI 门禁红了想快速定位是哪项指标或哪个 Issue 导致的，而不是去翻一整份报告。
  • DevOps 平台工程师：需要在 CI 流水线里解释质量门禁失败原因并跟踪修复进展。
  • 技术负责人：想确认新代码分支是否引入了新的 Bug 或安全热点，再决定能否放行发布。
  • 安全工程师：需要按安全热点逐项审查并确认，而不是把全部热点当成真实漏洞。