SonarQube Analyzer Skill

分析自托管的 SonarQube 项目，获取 issues 并建议自动化解决方案。

已注册工具

sonar_get_issues

获取 SonarQube 中某个项目或 PR 的 issues 列表。

参数：

• projectKey（字符串，必需）：项目密钥
• pullRequest（字符串，可选）：用于指定 PR 分析的 PR 编号
• severities（字符串数组，可选）：要过滤的严重级别（BLOCKER、CRITICAL、MAJOR、MINOR、INFO）
• status（字符串，可选）：issues 状态（OPEN、CONFIRMED、FALSE_POSITIVE 等）
• limit（数字，可选）：返回 issues 数量上限（默认：100）

示例：

{
  "projectKey": "openclaw-panel",
  "pullRequest": "5",
  "severities": ["CRITICAL", "MAJOR"],
  "limit": 50
}

sonar_analyze_and_suggest

基于 SonarQube 规则分析 issues 并提出修复建议。

参数：

• projectKey（字符串，必需）：项目密钥
• pullRequest（字符串，可选）：PR 编号
• autoFix（布尔值，可选）：是否尝试应用自动修复（默认：false）

示例：

{
  "projectKey": "openclaw-panel",
  "pullRequest": "5",
  "autoFix": false
}

sonar_quality_gate

检查项目的 Quality Gate 状态。

参数：

• projectKey（字符串，必需）：项目密钥
• pullRequest（字符串，可选）：PR 编号

示例：

{
  "projectKey": "openclaw-panel",
  "pullRequest": "5"
}

配置

该 skill 使用以下环境变量配置：

SONAR_HOST_URL=http://127.0.0.1:9000  # SonarQube 地址
SONAR_TOKEN=admin                      # 认证 Token

使用方法

分析特定 PR：

node scripts/analyze.js --project=my-project --pr=5

生成 issues 报告：

node scripts/report.js --project=my-project --format=markdown

检查 Quality Gate：

node scripts/quality-gate.js --project=my-project --pr=5

响应结构

sonar_get_issues

{
  "total": 12,
  "issues": [
    {
      "key": "...",
      "severity": "MAJOR",
      "component": "apps/web/src/ui/App.tsx",
      "line": 346,
      "message": "Extract this nested ternary...",
      "rule": "typescript:S3358",
      "status": "OPEN",
      "solution": "Extract nested ternary into a separate function..."
    }
  ],
  "summary": {
    "BLOCKER": 0,
    "CRITICAL": 0,
    "MAJOR": 2,
    "MINOR": 10,
    "INFO": 0
  }
}

sonar_analyze_and_suggest

{
  "projectKey": "openclaw-panel",
  "analysis": {
    "totalIssues": 12,
    "fixableAutomatically": 8,
    "requiresManualFix": 4
  },
  "suggestions": [
    {
      "file": "apps/web/src/ui/App.tsx",
      "line": 346,
      "issue": "Nested ternary operation",
      "suggestion": "Extract into independent component",
      "codeExample": "...",
      "autoFixable": false
    }
  ],
  "nextSteps": [
    "Run lint:fix for auto-fixable issues",
    "Refactor nested ternaries in App.tsx",
    "Replace || with ?? operators"
  ]
}

支持的自动化修复方案

系统要求

• Node.js 18+
• 可访问 SonarQube 实例（例如 localhost:9000）
• 已配置有效的认证 Token

与工作流集成

GitHub Actions 示例用法：

- name: Analyze with SonarQube Skill
  run: |
    npm install -g @felipeoff/sonarqube-analyzer
    sonarqube-analyzer 
      --project=my-project 
      --pr=${{ github.event.pull_request.number }} 
      --suggest-fixes