К основному содержанию
скилл CX Codex

sonarqube · claude-dev-suite — скилл для Claude Code: что делает и как установить

Настраивает проверку качества кода через SonarQube или SonarCloud. Помогает прописать quality gates, файл sonar-project.properties и шаги для CI/CD.

MIT 106 установок ★ 50 обновлён 2026-10-23

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add claude-dev-suite/claude-dev-suite --skill sonarqube -a claude-code
Открыть на GitHub

Что делает sonarqube

Скилл даёт ассистенту инструкции по интеграции SonarQube и облачного сервиса SonarCloud. Внутри собраны готовые шаблоны параметров sonar-project.properties, запуск локального контейнера через docker-compose.yml, настройки плагина для сборки Maven и вызовы REST API для контроля статуса гейтов.

Инструкции рассчитаны на глубокий анализ проекта и не подходят для быстрого локального линтинга JavaScript через Biome или ESLint. Без корректно заданного секрета SONAR_TOKEN в пайплайне сканирование завершится сбоем.

Какие задачи решает

  • настроить конфигурационный файл sonar-project.properties с путями к отчётам покрытия
  • запустить локальный сервер SonarQube через Docker Compose с базой PostgreSQL
  • внедрить шаг анализа SonarCloud в автоматический пайплайн сборки
  • задать пороговые значения quality gates для проверки входящих изменений

Примеры запросов агенту

  • Сделай конфиг sonar-project.properties и исключи тестовые файлы из расчёта покрытия
  • Подготовь файл docker-compose.yml для локального запуска SonarQube с PostgreSQL
  • Настрой проверку качества в пайплайне для автоматического сканирования через SonarCloud

Как установить sonarqube

1Через Skills CLI (Vercel)

npx skills add claude-dev-suite/claude-dev-suite --skill sonarqube -a claude-code

2Вручную: положить файлы

~/.claude/skills/sonarqube/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/sonarqube/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о sonarqube

Как установить sonarqube в Claude Code?

Выполните в терминале команду npx skills add claude-dev-suite/claude-dev-suite --skill sonarqube -a claude-code.

Что делает скилл sonarqube?

Он подсказывает ассистенту правила настройки SonarQube и SonarCloud, оформления порогов качества и подключения сканера в CI/CD.

Заменит ли этот скилл локальные линтеры вроде ESLint?

Нет, для проверки форматирования и быстрого линтинга инструкция рекомендует использовать специализированные линтеры.

Исходный текст

SKILL.md · MIT
---
name: sonarqube
description: |
  SonarQube/SonarCloud integration for continuous code quality.
  Setup, configuration, quality gates, and CI/CD integration.

  USE WHEN: user mentions "SonarQube", "SonarCloud", "quality gates", asks about "code coverage", "technical debt", "code smells", "sonar-project.properties", "SonarScanner"

  DO NOT USE FOR: ESLint/Biome - use linting skills, OWASP security - use security skills, testing tools - use Vitest/Playwright skills
allowed-tools: Read, Grep, Glob
---

# SonarQube / SonarCloud

## When NOT to Use This Skill
- **JavaScript/TypeScript linting** - Use `eslint-biome` skill for faster feedback
- **Security scanning** - Use `owasp-top-10` or security-scanner MCP
- **Test execution** - Use Vitest/Playwright skills for running tests
- **Code coverage generation** - Use JaCoCo/Vitest skills for coverage

> **Deep Knowledge**: Use `mcp__documentation__fetch_docs` with technology: `sonarqube` for comprehensive documentation.

## Official Documentation

| Resource | Link |
|----------|------|
| **SonarQube Docs** | https://docs.sonarsource.com/sonarqube/latest/ |
| **SonarCloud Docs** | https://docs.sonarsource.com/sonarcloud/ |
| **Rules Repository** | https://rules.sonarsource.com/ |
| **API Reference** | https://sonarcloud.io/web_api/ |

---

## Quick Setup

### SonarCloud (Recommended for Open Source)

```bash
# 1. Connect repo at sonarcloud.io
# 2. Create sonar-project.properties
```

```properties
# sonar-project.properties
sonar.projectKey=org_project
sonar.organization=your-org
sonar.sources=src
sonar.tests=tests
sonar.javascript.lcov.reportPaths=coverage/lcov.info
sonar.coverage.exclusions=**/*.test.ts,**/*.spec.ts
```

### SonarQube (Self-hosted)

```yaml
# docker-compose.yml
services:
  sonarqube:
    image: sonarqube:lts-community
    ports:
      - "9000:9000"
    environment:
      - SONAR_JDBC_URL=jdbc:postgresql://db:5432/sonar
    volumes:
      - sonarqube_data:/opt/sonarqube/data
```

---

## Quality Gates

### Default Quality Gate Conditions

| Metric | Condition | Target |
|--------|-----------|--------|
| Coverage | on new code | ≥ 80% |
| Duplicated Lines | on new code | ≤ 3% |
| Maintainability Rating | on new code | A |
| Reliability Rating | on new code | A |
| Security Rating | on new code | A |
| Security Hotspots Reviewed | on new code | 100% |

### Custom Quality Gate

```bash
# Create via API
curl -X POST "https://sonarcloud.io/api/qualitygates/create" \
  -H "Authorization: Bearer $SONAR_TOKEN" \
  -d "name=Strict"
```

---

## CI/CD Integration

### GitHub Actions

```yaml
# .github/workflows/sonar.yml
name: SonarCloud
on: [push, pull_request]

jobs:
  sonarcloud:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - name: SonarCloud Scan
        uses: SonarSource/sonarcloud-github-action@master
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
          SONAR_TOKEN: ${{ secrets.SONAR_TOKEN }}
```

### Maven (Java)

```xml
<!-- pom.xml -->
<plugin>
    <groupId>org.sonarsource.scanner.maven</groupId>
    <artifactId>sonar-maven-plugin</artifactId>
    <version>3.10.0.2594</version>
</plugin>
```

```bash
mvn sonar:sonar \
  -Dsonar.projectKey=project \
  -Dsonar.host.url=https://sonarcloud.io \
  -Dsonar.token=$SONAR_TOKEN
```

---

## Key Metrics

| Metric | Description | Good Value |
|--------|-------------|------------|
| **Bugs** | Reliability issues | 0 |
| **Vulnerabilities** | Security issues | 0 |
| **Code Smells** | Maintainability issues | Minimize |
| **Coverage** | Test coverage % | > 80% |
| **Duplications** | Duplicated code % | < 3% |
| **Cognitive Complexity** | Code understandability | < 15/function |

---

## Language-Specific Rules

| Language | Rules | Link |
|----------|-------|------|
| JavaScript/TS | 422 | https://rules.sonarsource.com/javascript/ |
| Java | 733 | https://rules.sonarsource.com/java/ |
| Python | 300+ | https://rules.sonarsource.com/python/ |
| C# | 400+ | https://rules.sonarsource.com/csharp/ |
| Go | 100+ | https://rules.sonarsource.com/go/ |

---

## Excluding Files

```properties
# sonar-project.properties
sonar.exclusions=**/node_modules/**,**/dist/**,**/*.test.ts
sonar.coverage.exclusions=**/tests/**,**/__mocks__/**
sonar.cpd.exclusions=**/generated/**
```

---

## API Examples

```bash
# Get project status
curl "https://sonarcloud.io/api/qualitygates/project_status?projectKey=KEY" \
  -H "Authorization: Bearer $SONAR_TOKEN"

# Get issues
curl "https://sonarcloud.io/api/issues/search?componentKeys=KEY&types=BUG" \
  -H "Authorization: Bearer $SONAR_TOKEN"

# Get metrics
curl "https://sonarcloud.io/api/measures/component?component=KEY&metricKeys=coverage,bugs,vulnerabilities" \
  -H "Authorization: Bearer $SONAR_TOKEN"
```

---

## Anti-Patterns

| Anti-Pattern | Why It's Bad | Correct Approach |
|--------------|--------------|------------------|
| No quality gate on PRs | Merging bad code | Enable PR decoration, block on failure |
| Excluding all tests from coverage | Inflated coverage numbers | Only exclude test utilities |
| Ignoring code smells | Technical debt accumulates | Fix or justify with comments |
| No coverage reporting | Can't track quality trends | Configure coverage reports in CI |
| Using default quality gate | Too lenient for most projects | Create custom stricter gate |
| Not reviewing Security Hotspots | Potential vulnerabilities missed | Review all hotspots before release |

## Quick Troubleshooting

| Issue | Likely Cause | Solution |
|-------|--------------|----------|
| Quality gate failed unexpectedly | New code coverage < 80% | Add tests or adjust coverage target |
| Analysis not running | Missing SONAR_TOKEN | Add token to CI secrets |
| Coverage always 0% | Wrong report path | Check `sonar.javascript.lcov.reportPaths` |
| Duplicated code false positives | Boilerplate code | Add to `sonar.cpd.exclusions` |
| Too many issues reported | First scan on legacy code | Use "New Code" focus, fix incrementally |
| PR decoration not working | Missing GitHub App integration | Configure SonarCloud GitHub App |

---

## Related Skills
- [Quality Principles](../common/SKILL.md)
- [GitHub Actions](../../ci-cd/github-actions/SKILL.md)
- [JaCoCo](../jacoco/SKILL.md)

© claude-dev-suite · MIT · claude-dev-suite/claude-dev-suite

Похожие скиллы

Все скиллы по теме «Код-ревью и рефакторинг» →

Сначала — sonarqube от других авторов.

sonarqube DougTrajano Позволяет агенту работать с проектами SonarQube через CLI sonar: проверять статус quality gate, находить баги, сканировать секреты и запускать анализ изменений. CX Codex +1 ★ 381звёзд репо sonarqube-mcp giuseppe-trisciuoglio Скилл sonarqube-mcp для Claude Code подключает проверки SonarQube и SonarCloud к рабочему процессу агента. Он срабатывает на запросы о quality gate, проблемах и правилах Sonar. CX Codex +1 3 800установок SonarQube MCP Server SonarSource Подключает SonarQube Server или Cloud к ИИ-ассистенту: агент видит метрики качества и уязвимости и умеет разбирать фрагмент кода прямо в контексте. CX Codex +1 ★ 693звёзд репо sast-scanning devops-skills Скилл sast-scanning для Claude Code: статический анализ исходников на уязвимости до деплоя. Встраивается security-гейтом в CI/CD-пайплайн. CX Codex +1 415установок ai-quality-gate mustafacagri MCP-сервер ai-quality-gate проверяет код, который написал ИИ, через ESLint и Prettier, сам правит что может и отдаёт агенту список оставшихся ошибок. CX Codex +1 ★ 31звёзд репо qe-quality-assessment proffesor-for-testing Скилл qe-quality-assessment для Claude Code оценивает качество кода по сложности, линту, запахам и здоровью тестов. Проверяет quality gates, формирует отчёты и оценивает готовность релиза. CX Codex +1 129установок fallow-setup fallow-rs Скилл fallow-setup настраивает проверки качества кода в JavaScript и TypeScript репозитории: ставит Fallow и добавляет гейт в CI. Пригодится при создании проекта. CX Codex +1 213установок

Из того же набора14

Весь набор →
email-sending Скилл email-sending для Claude Code подключает отправку транзакционных писем, шаблоны и почтовые сервисы. Отправляет welcome-письма, сбросы пароля и уведомления. CX Codex +1 188установок cron-scheduling Скилл cron-scheduling для Claude Code помогает задавать cron-расписания и планировать фоновые задачи в Node.js, Java и Python. Описывает периодические запуски и распределённое планирование. CX Codex +1 162установок iec61131 Разбирает языки PLC, типы данных и организацию программ по IEC 61131-3. Помогает обсуждать стандарты и обмен проектами между платформами. CX Codex +1 154установок plsql Oracle PL/SQL — процедуры, функции, пакеты, триггеры, курсоры, коллекции и обработка исключений. CX Codex +1 106установок socket-io Добавляет в агент паттерны для работы с Socket.IO: комнаты, авторизацию через middleware, типизацию в TypeScript и масштабирование через Redis. CX Codex +1 106установок spring-webflux Помогает писать реактивный код на Spring WebFlux в Spring Boot 3.x. Подключается к задачам с Mono, Flux, WebClient и R2DBC. CX Codex +1 102установок sqlserver Справочник по диалекту Microsoft SQL Server: типы данных, даты, строки, JSON и автоинкремент. CX Codex +1 102установок nats Объясняет Core NATS, JetStream и обмен запросами с ответом. Подключается к вопросам о NATS, шаблонах subject и связи микросервисов. CX Codex +1 101установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой