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

qe-test-generation — скилл для Claude Code: генерация тестов

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

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

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

Что делает qe-test-generation

Скилл анализирует код и предлагает тесты для методов, ветвей, зависимостей и путей ошибок. Он ставит выше проверки инвариантов, контрактов и свойств на границах модулей, а примеры и проверки вызовов моков помечает как временные. Каждый тест получает тег уровня: durable, ephemeral или live.

Можно задавать фреймворк, тип теста, целевое покрытие или шаблон, например для слоя сервисов. Поддерживаются unit- и integration-тесты для Jest, Vitest, Mocha, Pytest и JUnit; для Jest и Vitest также описаны e2e-тесты с ограничениями. Генерацию больших файлов стоит ограничивать отдельными модулями: на файлах больше 3000 строк агент может обрезать результат.

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

  • проверить инварианты на границах модуля
  • найти непокрытые ветви и пути ошибок
  • создать unit- и integration-тесты для изменённого кода
  • перенести тесты между Jest, Vitest и Playwright

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

  • Сгенерируй тесты для src/services/PaymentService.ts, сначала проверив публичные контракты и инварианты.
  • Найди пробелы в покрытии src/api/ и добавь unit-тесты для непокрытых ветвей.
  • Подготовь тесты для src/repositories/ с проверками свойств и контрактов.

Как установить qe-test-generation

1Через Skills CLI (Vercel)

npx skills add proffesor-for-testing/agentic-qe --skill qe-test-generation -a claude-code

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

~/.claude/skills/qe-test-generation/SKILL.md

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

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

Вопросы о qe-test-generation

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

Выполните npx skills add proffesor-for-testing/agentic-qe --skill qe-test-generation -a claude-code. Файл скилла появится по пути ~/.claude/skills/qe-test-generation/SKILL.md.

Что делает qe-test-generation?

Анализирует код и генерирует тесты, начиная с проверок инвариантов, контрактов и свойств. Также помогает закрывать пробелы в покрытии и готовить unit-, integration- и e2e-тесты.

Какие фреймворки поддерживает скилл?

В описании перечислены Jest, Vitest, Mocha, Pytest и JUnit. Unit- и integration-тесты предусмотрены для всех пяти; e2e указаны для Jest и Vitest с ограничениями.

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

SKILL.md · MIT
---
name: "qe-test-generation"
description: "Generates durable-first tests — invariants, contracts, and property-based tests at boundaries that survive a reimplementation — plus unit, integration, and e2e coverage. Use when creating tests for new or changed code, filling coverage gaps, or migrating test suites between Jest, Vitest, and Playwright."
trust_tier: 3
validation:
  schema_path: schemas/output.json
  validator_path: scripts/validate-config.json
  eval_path: evals/qe-test-generation.yaml
---

# QE Test Generation

## Purpose

Guide the use of v3's AI-powered test generation capabilities including pattern-based test synthesis, multi-framework support, and intelligent test case derivation from code analysis.

## Write durable-first (the core rule)

When AI makes code cheap to regenerate, the durable asset is the test that still
holds after the implementation is thrown away and rewritten. Generate tests in
**durability tiers**, and lead with the durable ones (ADR-113):

| Tier | What it is | Survives a rewrite? | When to write |
|------|-----------|---------------------|---------------|
| **Durable** | Invariants, contracts/schemas, property-based tests, behavioral e2e — specified at the module's public boundary | **Yes** | **Always — ≥1 per target** |
| **Ephemeral** | Example-based unit tests, mock-call/interaction tests (TDD-London style) | No (coupled to impl) | For the red-green loop; label them, delete freely |
| **Live** | Monitoring / drift / cost assertions that run against reality | Continuously | For deployed behavior |

**The language-swap heuristic:** *if reimplementing this module in another language
would invalidate the test, the test is at the wrong boundary.* Push it up a tier —
assert on the observable contract, not on how the current code happens to work.

Every generated target MUST include at least one **durable** assertion (an invariant,
a contract check, or a property). Mock-call assertions (`toHaveBeenCalledWith`) are
ephemeral by definition — never let them be the only thing testing a target. Tag each
generated test `// @tier durable|ephemeral|live` so its lifetime is explicit.

These tests are graded as **oracles**: a good test passes against the real code and
*fails* against a seeded bug (mutant). A test that asserts nothing, or only the happy
path, kills no mutants and is rejected — see `/mutation-testing` and ADR-113.

## Activation

- When generating tests for new code
- When improving test coverage
- When migrating tests between frameworks
- When applying TDD patterns
- When generating edge case tests

## Quick Start

```bash
# Generate unit tests for a file
aqe test generate --file src/services/UserService.ts --framework jest

# Generate tests with coverage target
aqe test generate --scope src/api/ --coverage 90 --type unit

# Generate integration tests
aqe test generate --file src/controllers/AuthController.ts --type integration

# Generate from patterns
aqe test generate --pattern repository --target src/repositories/
```

## Agent Workflow

```typescript
// Spawn test generation agents — durable-first
Task("Generate durable-first tests", `
  Analyze src/services/PaymentService.ts and generate Jest tests in tier order.
  1. DURABLE (write these first, >=1 per public method):
     - Invariants ("a refund never makes a balance negative")
     - Contract/schema checks on inputs and outputs crossing the boundary
     - Property-based tests (fast-check) over input ranges, not single examples
  2. EPHEMERAL (the red-green loop; tag '// @tier ephemeral'):
     - Specific happy-path examples and error paths
     - Mock external dependencies ONLY — never let a mock-call assertion be the
       only test for a method
  Apply the language-swap check: if a Python rewrite of PaymentService would break
  the test, move it up to the durable tier.
  Output to tests/unit/services/PaymentService.test.ts
`, "qe-test-architect")

// Property + contract generation (first-class, not opt-in)
Task("Generate property and contract tests", `
  For src/repositories/, derive:
  - Properties: round-trip (write→read returns same), idempotence, ordering invariants
  - Contracts: the repository interface schema, enforced on every CRUD result
  These survive a storage-engine swap; example-based CRUD tests do not.
`, "qe-property-tester")
```

## Test Generation Strategies

### 1. Code Analysis Based

```typescript
await testGenerator.analyzeAndGenerate({
  source: 'src/services/OrderService.ts',
  analysis: {
    methods: true,
    branches: true,
    dependencies: true,
    errorPaths: true
  },
  output: {
    framework: 'jest',
    style: 'describe-it',
    assertions: 'expect'
  }
});
```

### 2. Pattern-Based Generation

```typescript
await testGenerator.applyPattern({
  pattern: 'service-layer',
  targets: ['src/services/*.ts'],
  customizations: {
    mockStrategy: 'jest.mock',
    asyncHandling: 'async-await',
    errorAssertion: 'toThrow'
  }
});
```

### 3. Coverage-Driven Generation

```typescript
await testGenerator.fillCoverageGaps({
  coverageReport: 'coverage/lcov.info',
  targetCoverage: 90,
  prioritize: ['uncovered-branches', 'error-paths'],
  maxTests: 50
});
```

## Framework Support

| Framework | Unit | Integration | E2E | Mocking |
|-----------|------|-------------|-----|---------|
| Jest | ✅ | ✅ | ⚠️ | jest.mock |
| Vitest | ✅ | ✅ | ⚠️ | vi.mock |
| Mocha | ✅ | ✅ | ❌ | sinon |
| Pytest | ✅ | ✅ | ❌ | pytest-mock |
| JUnit | ✅ | ✅ | ❌ | Mockito |

## Test Quality Checks

```yaml
quality_checks:
  durability:                  # the primary check (ADR-113)
    durable_assertions_per_target: 1   # >=1 invariant/contract/property each
    language_swap_safe: true           # would survive a reimplementation
    tier_tags_present: true            # every test tagged durable|ephemeral|live

  fault_detection:             # do the tests actually catch bugs?
    mutation_score_min: 0.6            # kill rate against seeded mutants
    no_assertionless_tests: true       # reject tests that kill 0 mutants

  assertions:
    minimum_per_test: 1
    meaningful: true

  isolation:
    no_shared_state: true
    proper_setup_teardown: true

  naming:
    descriptive: true
    follows_convention: true

  coverage:                    # necessary but NOT sufficient — see fault_detection
    branches: 80
    statements: 85
```

## Skill Composition

- **After generating tests** → Run `/mutation-testing` to verify test quality
- **Before generating** → Use `/test-automation-strategy` to choose framework and patterns
- **Related** → `/qe-coverage-analysis` to find where tests are needed most

## Gotchas

- Agent truncates output on files >3000 lines — scope generation to individual modules, not entire directories
- Components that pass unit tests individually may have zero integration wiring — always generate at least one integration test per module boundary
- When generating tests for a new codebase, check which framework is installed (jest vs vitest vs mocha) — they have different mock APIs and Claude will use the wrong one
- Completion theater: agent may claim "comprehensive tests generated" but leave stubs or hardcoded values — always run the generated tests before accepting
- Fleet must be initialized before using QE agents: run `aqe health` to diagnose, or `aqe init` to re-initialize if you get "Fleet not initialized"

## Coordination

**Primary Agents**: qe-test-generator, qe-pattern-matcher, qe-test-architect
**Coordinator**: qe-test-generation-coordinator
**Related Skills**: qe-coverage-analysis, qe-test-execution

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

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

Все скиллы по теме «Тесты и QA» →
test-detect davila7 Скилл test-detect определяет тестовый фреймворк в проекте и запускает подходящую проверку. Он также находит тесты для файла и создаёт базовые тесты. CX Codex +1 56установок ai-test-generation kindlmann Скилл ai-test-generation для Claude Code строит пошаговый конвейер генерации новых автотестов из спецификаций, диффов кода, баг-репортов и схем OpenAPI. Защищает от выдуманных ручек API и пустых ассертов. CX Codex +1 1 600установок test-automation-expert curiositech Скилл test-automation-expert для Claude Code помогает выстроить стратегию тестирования, определить покрытие, выбрать фреймворк и отладить флаки-тесты. CX Codex +1 212установок test-guard amElnagdy Скилл test-guard для Claude Code и других агентов проверяет сгенерированные тесты на избыточность, лишние моки и совпадение с логикой проекта перед коммитом. Работает с pytest, Jest, Vitest, Go и PHPUnit. CX Codex +1 4 400установок parallel-test-fixing spencerpauly Скилл parallel-test-fixing распределяет упавшие файлы тестов между параллельными субагентами, чтобы исправлять ошибки независимо. Он нужен при поломке сразу нескольких тестовых файлов. CX Codex +1 455установок test-audit mblode Скилл test-audit для Claude Code, Cursor, Codex и других агентов, который вырезает малоценные тесты из сьюта до заданной цели, сохраняя покрытие. Запускается как точечный аудит папки или кампания на весь репозиторий с числовым таргетом. CX Codex +1 283установок

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

Весь набор →
security-testing Скилл security-testing для Claude Code проверяет проект на уязвимости по методике OWASP Top 10. Подключается для аудита авторизации, поиска инъекций и настройки автоматических проверок. CX Codex +1 152установок pentest-validation Скилл pentest-validation проверяет отчёты SAST и DAST на реальную эксплуатируемость, отсеивает ложные срабатывания и строит PoC без тестов на проде. CX Codex +1 147установок database-testing Скилл database-testing для Claude Code проверяет схемы БД, целостность данных, миграции, транзакции и производительность запросов. Включается при проверке сохранения данных и изменений схемы. CX Codex +1 146установок performance-testing Скилл performance-testing для Claude Code помогает спланировать нагрузочный тест, задать SLO и найти узкие места по результатам. Проверяет API и поведение приложения под нагрузкой. CX Codex +1 144установок qe-requirements-validation Скилл qe-requirements-validation для Claude Code проверяет тестируемость критериев приёмки, связывает требования с тест-кейсами и генерирует BDD-сценарии из пользовательских историй. Проверяет полноту требований до разработки. CX Codex +1 141установок refactoring-patterns Скилл refactoring-patterns для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode, который применяет паттерны рефакторинга. Запускается, когда нужно улучшить структуру кода без изменения поведения. CX Codex +1 140установок chaos-engineering-resilience Скилл chaos-engineering-resilience для контролируемого внедрения сбоев в распределённые системы, проверки восстановления и валидации устойчивости к отказам. Помогает найти слабые места до того, как их обнаружат пользователи. CX Codex +1 138установок localization-testing Скилл localization-testing проверяет переводы, форматы по локали, RTL-интерфейс и поддержку Unicode. Пригодится перед запуском продукта на новых языках и после изменений UI. CX Codex +1 137установок

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

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