sonarcloud-tools

bsamiee 的头像作者 bsamiee

通过统一的Python CLI执行SonarCloud API查询。在检查质量门状态、搜索问题(错误、漏洞、代码异味)、检索指标(覆盖率、复杂度)或查看分析历史时使用。

📖 中文导读:通过统一的Python CLI执行SonarCloud API查询。在检查质量门状态、搜索问题(错误、漏洞、代码异味)、检索指标(覆盖率、复杂度)或查看分析历史时使用。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: sonarcloud-tools type: complex depth: base user-invocable: false description: >- Executes SonarCloud API queries via unified Python CLI. Use when checking quality gate status, searching issues (bugs, vulnerabilities, code smells), retrieving metrics (coverage, complexity), or viewing analysis history.

[H1][SONARCLOUD-TOOLS]

Dictum: Zero-arg defaults enable immediate code quality inspection.


Execute SonarCloud queries through unified Python CLI.

[IMPORTANT] Commands accept zero arguments. Defaults: project=bsamiee_Parametric_Portal, organization=bsamiee. 1Password auto-injects API token.


[0][SCANNER]

Dictum: Local scanner enables pre-push quality gates.


Run Analysis:

pnpm sonar

Requirements:

  • SONAR_TOKEN environment variable (1Password injection or export)
  • Coverage reports at packages/*/coverage/lcov.info (run nx run-many -t test first)

Configuration: sonar-project.properties at repo root.


[1][API_QUERIES]

# Zero-arg invocation (most common)
uv run .claude/skills/sonarcloud-tools/scripts/sonarcloud.py issues
uv run .claude/skills/sonarcloud-tools/scripts/sonarcloud.py hotspots
uv run .claude/skills/sonarcloud-tools/scripts/sonarcloud.py quality-gate
uv run .claude/skills/sonarcloud-tools/scripts/sonarcloud.py measures
uv run .claude/skills/sonarcloud-tools/scripts/sonarcloud.py analyses
uv run .claude/skills/sonarcloud-tools/scripts/sonarcloud.py projects

# Filtered queries
uv run .claude/skills/sonarcloud-tools/scripts/sonarcloud.py issues --severities BLOCKER,CRITICAL
uv run .claude/skills/sonarcloud-tools/scripts/sonarcloud.py issues --types BUG,VULNERABILITY
uv run .claude/skills/sonarcloud-tools/scripts/sonarcloud.py hotspots --status TO_REVIEW
uv run .claude/skills/sonarcloud-tools/scripts/sonarcloud.py quality-gate --branch main
uv run .claude/skills/sonarcloud-tools/scripts/sonarcloud.py quality-gate --pull-request 42
uv run .claude/skills/sonarcloud-tools/scripts/sonarcloud.py measures --metrics coverage,bugs,vulnerabilities

[2][OUTPUT]

Commands return: {"status": "success|error", ...}.

[INDEX] [CMD] [RESPONSE]
[1] issues {project, total, issues[], summary}
[2] hotspots {project, total, hotspots[]}
[3] quality-gate {project, status, passed: bool, conditions[]}
[4] measures {project, name, metrics}
[5] analyses {project, total, analyses[]}
[6] projects {organization, total, projects[]}