用途：通过统一 Python CLI 执行 SonarCloud 查询，用于代码质量检查，包括质量门状态、问题搜索（Bug、漏洞、代码异味）与热点等。命令支持零参数调用，默认 project=bsamiee_Parametric_Portal，organization=bsamiee，API 令牌由 1Password 自动注入。
主要能力：支持 issues、hotspots、quality-gate、measures、analyses、projects 等查询；可带过滤条件，如 --severities BLOCKER,CRITICAL、--types BUG,VULNERABILITY、--status TO_REVIEW、--branch main、--pull-request 42、--metrics coverage,bugs,vulnerabilities。命令返回 {"status": "success|error", ...} 结构。
本地扫描：运行 pnpm sonar 执行分析，需 SONAR_TOKEN 环境变量（1Password 注入或手动 export），覆盖率报告位于 packages/*/coverage/lcov.info（先运行 nx run-many -t test），配置文件为仓库根目录 sonar-project.properties。
用法示例：uv run .claude/skills/sonarcloud-tools/scripts/sonarcloud.py issues（或 hotspots、quality-gate、measures、analyses、projects）。
适用场景：推送前的本地质量门检查、CI 中查询质量门与问题、按分支或 PR 查看状态、按指标获取度量。
限制：默认项目和组织固定，其他项目需自行覆盖参数；令牌与覆盖率报告路径需满足上述要求；资料未提供计费、平台支持范围与更多错误处理细节。