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

qe-quality-assessment — скилл для Claude Code: установка

Скилл qe-quality-assessment для Claude Code оценивает качество кода по сложности, линту, запахам и здоровью тестов. Проверяет quality gates, формирует отчёты и оценивает готовность релиза.

MIT 129 установок ★ 533 обновлён 2026-10-25

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

Что делает qe-quality-assessment

Скилл собирает оценку из нескольких измерений: сложности кода, поддерживаемости, дублирования, покрытия тестами, mutation score, уязвимостей, технического долга и документации. Он умеет задавать quality gates с порогами, разделять состояния pass, fail и warn, считать итоговую оценку с грейдом от A до F и формировать рекомендации.

Для проверки релиза используются команды aqe quality assess, aqe quality deploy-ready, aqe quality report и aqe quality compare. В примерах также есть анализатор качества и советник по готовности развёртывания, CI/CD-проверка с сохранением report.json и история запусков в run-history.json. Проверка regenerability по умолчанию работает в режиме предупреждения, а не блокирует pipeline.

Скилл рассчитан на Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. Для установки в Claude Code нужны npx и репозиторий proffesor-for-testing/agentic-qe; после команды файл появляется в ~/.claude/skills/qe-quality-assessment/SKILL.md.

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

  • оценить сложность и поддерживаемость кода
  • настроить пороги quality gates для CI
  • проверить готовность релиза к production
  • сравнить качество между версиями
  • сформировать отчёт с оценкой и рекомендациями

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

  • Оцени качество кода в src/, проверь complexity, покрытие, уязвимости и технический долг, затем дай итоговый score.
  • Проверь готовность релиза v2.1.0 к production и вынеси рекомендацию go/no-go по тестам, уязвимостям и документации.
  • Сформируй отчёт о качестве в формате dashboard за 30d и сравни релизы v1.0 и v2.0.

Как установить qe-quality-assessment

1Через Skills CLI (Vercel)

npx skills add proffesor-for-testing/agentic-qe --skill qe-quality-assessment -a claude-code

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

~/.claude/skills/qe-quality-assessment/SKILL.md

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

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

Вопросы о qe-quality-assessment

Как установить qe-quality-assessment в Claude Code?

Выполните npx skills add proffesor-for-testing/agentic-qe --skill qe-quality-assessment -a claude-code. Скилл будет доступен в ~/.claude/skills/qe-quality-assessment/SKILL.md.

Что делает qe-quality-assessment?

Скилл оценивает качество кода, проверяет quality gates и готовность релиза. Он объединяет метрики сложности, тестов, безопасности, документации и технического долга в отчёт с pass/fail-вердиктом.

Как работает проверка regenerability?

Она учитывает mutation score и долговечность тестовой опоры модуля. Режим warn предупреждает о проблеме, а режим block может остановить CI.

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

SKILL.md · MIT
---
name: "qe-quality-assessment"
description: "Evaluates code quality through complexity analysis, lint results, code smell detection, and test health metrics. Use when assessing deployment readiness, configuring quality gates, scoring a codebase for release, or generating quality reports with pass/fail verdicts."
trust_tier: 3
validation:
  schema_path: schemas/output.json
  validator_path: scripts/validate-config.json
  eval_path: evals/qe-quality-assessment.yaml
---

# QE Quality Assessment

## Purpose

Guide the use of v3's quality assessment capabilities including automated quality gates, metrics aggregation, trend analysis, and deployment readiness evaluation.

## Activation

- When evaluating code quality
- When setting up quality gates
- When assessing deployment readiness
- When tracking quality metrics
- When generating quality reports

## Quick Start

```bash
# Run quality assessment
aqe quality assess --scope src/ --gates all

# Check deployment readiness
aqe quality deploy-ready --environment production

# Generate quality report
aqe quality report --format dashboard --period 30d

# Compare quality between releases
aqe quality compare --from v1.0 --to v2.0
```

## Agent Workflow

```typescript
// Comprehensive quality assessment
Task("Assess code quality", `
  Evaluate quality for src/:
  - Code complexity (cyclomatic, cognitive)
  - Test coverage and mutation score
  - Security vulnerabilities
  - Code smells and technical debt
  - Documentation coverage
  Generate quality score and recommendations.
`, "qe-quality-analyzer")

// Deployment readiness check
Task("Check deployment readiness", `
  Evaluate if release v2.1.0 is ready for production:
  - All tests passing
  - Coverage thresholds met
  - No critical vulnerabilities
  - Performance benchmarks passed
  - Documentation updated
  Provide go/no-go recommendation.
`, "qe-deployment-advisor")
```

## Quality Dimensions

### 1. Code Quality Metrics

```typescript
await qualityAnalyzer.assessCode({
  scope: 'src/**/*.ts',
  metrics: {
    complexity: {
      cyclomatic: { max: 15, warn: 10 },
      cognitive: { max: 20, warn: 15 }
    },
    maintainability: {
      index: { min: 65 },
      duplication: { max: 3 }  // percent
    },
    documentation: {
      publicAPIs: { min: 80 },
      complexity: { min: 70 }
    }
  }
});
```

### 2. Quality Gates

```typescript
await qualityGate.evaluate({
  gates: {
    coverage: { min: 80, blocking: true },
    // Fault detection — coverage is necessary but NOT sufficient (ADR-113).
    // A suite can hit 90% coverage and catch no bugs; mutation score does not lie.
    mutationScore: { min: 0.6, blocking: false },   // warn-by-default; opt-in blocking
    regenerability: { min: 0.5, blocking: false },  // Deletion Test: durable oracle backing per module
    complexity: { max: 15, blocking: false },
    vulnerabilities: { critical: 0, high: 0, blocking: true },
    duplications: { max: 3, blocking: false },
    techDebt: { maxRatio: 5, blocking: false }
  },
  action: {
    onPass: 'proceed',
    onFail: 'block-merge',
    onWarn: 'notify'
  }
});
```

### 2a. Regenerability gate (ADR-113)

Coverage measures lines executed; **mutation score** measures whether the tests would
*notice a bug*, and **regenerability** answers the Deletion Test — "if this module were
deleted and regenerated, would a wrong rebuild be caught?" Regenerability = mutation
score discounted by the durability tier backing the module (durable > live > ephemeral
> none); ephemeral-only tests score low because they don't survive a reimplementation.

```typescript
import { evaluateRegenerabilityGate } from '../../../src/feedback/regenerability-gate.js';

const verdict = evaluateRegenerabilityGate(moduleProfiles, {
  mutationScoreMin: 0.6,
  regenerabilityMin: 0.5,
  mode: 'warn',   // 'block' to fail CI; warn-by-default so adoption never breaks pipelines
});
// verdict.passed (thresholds met) · verdict.blocking (should fail CI) · verdict.failures[]
```

Surface it next to coverage in reports: `Coverage 88% ✅ / Mutation 41% ⚠️ / Regenerability: ephemeral-only ⚠️`.

### 3. Deployment Readiness

```typescript
await deploymentAdvisor.assess({
  release: 'v2.1.0',
  criteria: {
    testing: {
      unitTests: 'all-pass',
      integrationTests: 'all-pass',
      e2eTests: 'critical-pass',
      performanceTests: 'baseline-met'
    },
    quality: {
      coverage: 80,
      noNewVulnerabilities: true,
      noRegressions: true
    },
    documentation: {
      changelog: true,
      apiDocs: true,
      releaseNotes: true
    }
  }
});
```

## Quality Score Calculation

```yaml
quality_score:
  components:
    test_coverage:
      weight: 0.25
      metrics: [statement, branch, function]

    code_quality:
      weight: 0.20
      metrics: [complexity, maintainability, duplication]

    security:
      weight: 0.25
      metrics: [vulnerabilities, dependencies]

    reliability:
      weight: 0.20
      metrics: [bug_density, flaky_tests, error_rate]

    documentation:
      weight: 0.10
      metrics: [api_coverage, readme, changelog]

  scoring:
    A: 90-100
    B: 80-89
    C: 70-79
    D: 60-69
    F: 0-59
```

## Quality Dashboard

```typescript
interface QualityDashboard {
  overallScore: number;  // 0-100
  grade: 'A' | 'B' | 'C' | 'D' | 'F';
  dimensions: {
    name: string;
    score: number;
    trend: 'improving' | 'stable' | 'declining';
    issues: Issue[];
  }[];
  gates: {
    name: string;
    status: 'pass' | 'fail' | 'warn';
    value: number;
    threshold: number;
  }[];
  trends: {
    period: string;
    scores: number[];
    alerts: Alert[];
  };
  recommendations: Recommendation[];
}
```

## CI/CD Integration

```yaml
# Quality gate in pipeline
quality_check:
  stage: verify
  script:
    - aqe quality assess --gates all --output report.json
  rules:
    - if: $CI_PIPELINE_SOURCE == "merge_request_event"
  artifacts:
    reports:
      quality: report.json
  allow_failure:
    exit_codes:
      - 1  # Warnings only
```

## Run History

After each quality assessment, append results to `run-history.json` in this skill directory:
```bash
node -e "
const fs = require('fs');
const h = JSON.parse(fs.readFileSync('.claude/skills/qe-quality-assessment/run-history.json'));
h.runs.push({date: new Date().toISOString().split('T')[0], gate_result: 'PASS_OR_FAIL', failed_checks: []});
fs.writeFileSync('.claude/skills/qe-quality-assessment/run-history.json', JSON.stringify(h, null, 2));
"
```
Read `run-history.json` before each run — alert if quality gate failed 3 of last 5 runs.

## Skill Composition

- **Before assessment** → Run `/qe-coverage-analysis` and `/mutation-testing` first
- **If issues found** → Use `/test-failure-investigator` to diagnose failures
- **For PR review** → Combine with `/code-review-quality` for comprehensive review

## Gotchas

- NEVER trust agent-reported pass/fail status — 12 test failures were caught that agents claimed were passing (Nagual pattern, reward 0.92)
- Completion theater: agent hardcoded version '3.0.0' instead of reading from package.json — verify actual values in output
- Fix issues in priority waves (P0 → P1 → P2) with verification between each wave — don't fix everything in parallel
- quality-assessment domain has 53.7% success rate — expect failures and have fallback
- If HybridMemoryBackend initialization fails, run `aqe health` to diagnose, or `aqe init` to re-initialize

## Coordination

**Primary Agents**: qe-quality-analyzer, qe-deployment-advisor, qe-metrics-collector
**Coordinator**: qe-quality-coordinator
**Related Skills**: qe-coverage-analysis, security-testing

© proffesor-for-testing · MIT · proffesor-for-testing/agentic-qe

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

Все скиллы по теме «Тесты и QA» →
qa-expert zhaono1 Скилл qa-expert для Claude Code и Codex: планирует тестовое покрытие по уровням риска и настраивает quality gates на каждом этапе CI — от pre-commit до production. CX Codex +1 764установок improve-code-quality wondelai Скилл improve-code-quality для Claude Code и Codex ведёт проект от непротестированного прототипа к стабильному релизу. Пошаговый план фиксирует тесты, долг и архитектурные решения прямо в папке docs/. CX Codex +1 2 700установок Quality Assurance daffy0208 Скилл Quality Assurance задаёт правила тестирования, проверки кода и фазовых переходов в проекте. Помогает настроить пирамиду тестов и подготовить кодовую базу к релизу. CX Codex +1 206установок quality-auditor daffy0208 Скилл quality-auditor проводит аудит репозитория, кода и документации по 12 критериям с оценкой от 1 до 10. CX Codex +1 201установок quality-validation qodex-ai Скилл quality-validation запрещает ИИ-агенту заявлять о готовности задачи без свежих доказательств: запусков тестов, сборки или проверки диффа в Git. CX Codex +1 142установок oma-refactor First Fluke Скилл oma-refactor для Claude Code и Codex перестраивает структуру кода без изменений в его наблюдаемом поведении. Проводит точечный рефакторинг техдолга и горячих точек через мелкие проверенные шаги. CX Codex +1 ★ 1 472звёзд репо

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

Весь набор →
wms-testing-patterns Скилл wms-testing-patterns для Claude Code содержит паттерны проверки инвентаризации, волн комплектации, EDI-документов и интеграции WMS с ERP. CX Codex +1 134установок six-thinking-hats Скилл six-thinking-hats для Claude Code разбирает тестирование через шесть позиций: факты, риски, пользу, идеи, ощущения и план действий. Структурирует стратегии, ретроспективы и разбор сбоев. CX Codex +1 131установок a11y-ally Скилл a11y-ally для Claude Code проверяет страницы на нарушения WCAG и предлагает контекстные исправления. Аудирует сайты и проверяет доступность видео. CX Codex +1 131установок contract-testing Скилл contract-testing помогает настроить контрактное тестирование API и микросервисов с помощью Pact и предотвратить поломки при деплое. CX Codex +1 130установок qe-defect-intelligence Скилл qe-defect-intelligence анализирует код на вероятность ошибок по частоте изменений, сложности и истории багов. Помогает найти проблемные участки до того, как они попадут в продакшн. CX Codex +1 129установок risk-based-testing Скилл risk-based-testing распределяет ресурсы тестирования по уровню риска модулей по шкале от 1 до 5 и приоритизирует автотесты перед релизом. CX Codex +1 128установок n8n-trigger-testing-strategies Скилл n8n-trigger-testing-strategies для Claude Code тестирует триггеры n8n: вебхуки, cron-расписания, события и опрос. Помогает выяснить, почему воркфлоу срабатывает не тогда, когда ожидается. CX Codex +1 128установок n8n-expression-testing Скилл n8n-expression-testing проверяет синтаксис выражений n8n, их работу с контекстом и обработку пустых значений. Нужен при отладке преобразований данных. CX Codex +1 127установок

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

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