技能介绍

要解决什么问题

代码合入前往往缺少自动化的质量检查：单靠人工 review 容易漏掉坏味道，不同分支、不同环境的代码风格也可能悄悄漂移。团队如果同时使用 SonarCloud 和自建的 SonarQube 实例，接入方式不一致会让扫描流程难以统一。此外，质量门禁的结果分散在 Web 界面里，开发者需要频繁切换页面才能确认某次提交是否通过了检查。

它如何工作

这个技能封装了与 SonarQube REST API 的交互，核心能力包括：

触发并执行静态代码分析扫描，把仓库当前状态提交给 SonarQube 分析
检索质量门禁结果，直接回答"这次构建是否通过"
标记扫描发现的代码坏味道，帮助定位需要重构的位置
通过 token 认证接入实例，同时兼容 SonarCloud 与 本地部署的 SonarQube

使用时只需给出实例地址和访问令牌，技能即可完成从触发扫描到回收结果的完整链路。

适用边界与注意点

构建项目需要 Java 17 和 npm，环境需提前准备好
系统 PATH 中必须存在原生 Git，否则无法正常执行仓库相关操作
如果改动涉及 Web 界面，需要先克隆 sonarqube-webapp 仓库单独修改并构建，再通过 WEBAPP_BUILD_PATH 环境变量让主仓库使用该产物
只想构建、不想跑测试时，可以在 gradle 命令中加入 -x test 跳过测试阶段