用途：在 SonarQube 已就绪的前提下，把当前 AI 编码代理与 SonarQube 连接起来，本技能只负责“接线”，不负责搭建 SonarQube 本身。
主要能力：检查 PATH 上是否已有 sonar；按安装方式选择升级路径（包管理器安装走管理器升级，脚本安装或不确定时运行 sonar self-update）；检查认证状态；按代理类型执行集成，配置 SonarQube MCP 服务器、密钥扫描钩子，部分场景还包含 Vortex 分析与上下文增强；最后输出集成摘要。
使用方式：按技能指令分步执行。安装命令保持原样，如 macOS/Linux 脚本 curl -o- https://raw.githubusercontent.com/SonarSource/sonarqube-cli/refs/heads/master/user-scripts/install.sh | bash、Homebrew 的 brew install --cask sonarqube-cli、mise 的 mise use -g aqua:SonarSource/sonarqube-cli、Windows PowerShell 的 irm https://raw.githubusercontent.com/SonarSource/sonarqube-cli/refs/heads/master/user-scripts/install.ps1 | iex。登录使用 sonar auth login -o <org-key>（美国区加 -s https://sonarqube.us，自建服务器用 sonar auth login -s <server-url>），令牌存入系统钥匙串。集成命令按代理分别是 sonar integrate claude、copilot、codex、cursor、antigravity，均带 --non-interactive；Gemini CLI 与 Factory Droid 通过 sonar run mcp 自动启动 MCP 服务器，无对应 integrate 命令。
适用场景：Claude Code、Copilot CLI、Codex、Cursor、Antigravity、Gemini CLI、Factory Droid 等代理的环境初始化与维护。
限制：MCP 服务器运行在容器中，需要已安装并运行 Docker、Podman 或 Nerdctl，否则集成可能成功但会话中不出现 mcp__sonarqube__* 工具，且需重启代理会话；Cursor 的云端/后台代理只能读取项目内安装的钩子，读不到机器级钩子，且需在 Settings → MCP 中手动启用 sonarqube；Antigravity 未出现工具时也需重启会话；Gemini CLI 为旧版路径，不支持 SonarQube 钩子与 Vortex 分析接线，建议迁移到 Antigravity（agy plugin import gemini 后运行 sonar integrate antigravity）；Factory Droid 不支持钩子与 Vortex 接线。登录命令需用户自行在浏览器完成，技能不代为执行。具体支持的代理版本与全部可选参数资料未提供。