qe-test-execution — скилл для Claude Code: что делает и как установить
Скилл qe-test-execution для запуска тестов в Jest, Vitest и Playwright с параллелизацией через aqe, умным отбором по diff и автоповтором упавших проверок.
MIT 122 установок ★ 533 обновлён 2026-10-25
npx skills add proffesor-for-testing/agentic-qe --skill qe-test-execution -a claude-codeЧто делает qe-test-execution
Скилл координирует запуск тестовых наборов для фреймворков Jest, Vitest и Playwright через CLI-утилиту aqe. Он распределяет прогон по параллельным воркерам или шардам матрицы в CI/CD, отбирает тесты под изменения в git и перезапускает нестабильные проверки с заданной задержкой.
Под капотом задействованы специализированные агенты. Агент qe-test-executor берёт на себя параллельное исполнение и формирование JUnit-отчётов, qe-test-selector вычисляет затронутые файлы по HEAD~1, а qe-flaky-detector отслеживает частоту падений и отправляет сбойные тесты в карантин. Результаты агрегируются в единую структуру со статистикой покрытия и логами.
Параллельный запуск нередко маскирует нестабильные проверки. Поэтому при первом поиске причин падений автор советует запускать тесты строго в один поток через --workers=1. Полные прогоны внутри контейнеров рискуют упасть из-за нехватки оперативной памяти, так что промежуточные результаты следует сохранять на диск, а не держать в памяти сессии.
Какие задачи решает
- распараллелить запуск наборов тестов в Jest, Vitest и Playwright
- отобрать только затронутые тесты по изменениям в git
- настроить повторный прогон нестабильных проверок с задержкой
- разбить выполнение тестов на шарды для матрицы в CI/CD
Примеры запросов агенту
- Запусти только затронутые тесты относительно HEAD~1 с 4 параллельными воркерами
- Настрой прогон тестов через aqe с 3 повторами для нестабильных проверок и отчётом JUnit
- Сконфигурируй запуск тестов с шардированием для матрицы GitHub Actions на 4 потока
Как установить qe-test-execution
1Через Skills CLI (Vercel)
npx skills add proffesor-for-testing/agentic-qe --skill qe-test-execution -a claude-code2Вручную: положить файлы
~/.claude/skills/qe-test-execution/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/qe-test-execution/
1Через Skills CLI (Vercel)
npx skills add proffesor-for-testing/agentic-qe --skill qe-test-execution -a codex2Вручную: положить файлы
.agents/skills/qe-test-execution/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add proffesor-for-testing/agentic-qe --skill qe-test-execution -a cursor2Вручную: положить файлы
.cursor/skills/qe-test-execution/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install proffesor-for-testing/agentic-qe assets/skills/qe-test-execution2Вручную: положить файлы
.github/skills/qe-test-execution/SKILL.md1Через Skills CLI (Vercel)
npx skills add proffesor-for-testing/agentic-qe --skill qe-test-execution -a gemini-cli2Командой платформы
gemini skills install https://github.com/proffesor-for-testing/agentic-qe --path assets/skills/qe-test-executionВручную: положить файлы
.devin/skills/qe-test-execution/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add proffesor-for-testing/agentic-qe --skill qe-test-execution -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о qe-test-execution
Как установить qe-test-execution в Claude Code?
Выполните команду npx skills add proffesor-for-testing/agentic-qe --skill qe-test-execution -a claude-code. Файлы скилла будут сохранены по пути ~/.claude/skills/qe-test-execution/SKILL.md.
Что делает скилл qe-test-execution?
Он управляет параллельным запуском тестов Jest, Vitest и Playwright через команду aqe test run. Скилл анализирует изменения в коде, изолирует нестабильные проверки и собирает отчёты выполнения.
Как скилл справляется с нестабильными тестами?
В конфигурации задаётся порог частоты сбоев и количество повторных попыток с задержкой. Подозрительные проверки можно отправить в карантин и настроить оповещения в командный чат.
Исходный текст
SKILL.md · MIT
---
name: "qe-test-execution"
description: "Orchestrates test suite execution with parallel sharding, intelligent retry, and real-time reporting across Jest, Vitest, and Playwright. Use when running test suites, optimizing execution time, handling flaky tests, configuring CI test pipelines, or analyzing test run results."
trust_tier: 3
validation:
schema_path: schemas/output.json
validator_path: scripts/validate-config.json
eval_path: evals/qe-test-execution.yaml
---
# QE Test Execution
## Purpose
Guide the use of v3's test execution capabilities including parallel orchestration, smart test selection, flaky test handling, and distributed execution across multiple environments.
## Activation
- When running test suites
- When optimizing test execution time
- When handling flaky tests
- When setting up CI/CD test pipelines
- When executing tests across environments
## Quick Start
```bash
# Run all tests with parallelization
aqe test run --parallel --workers 4
# Run affected tests only
aqe test run --affected --since HEAD~1
# Run with retry for flaky tests
aqe test run --retry 3 --retry-delay 1000
# Run specific test types
aqe test run --type unit,integration --exclude e2e
```
## Agent Workflow
```typescript
// Orchestrate test execution
Task("Execute test suite", `
Run the full test suite with:
- 4 parallel workers
- Retry flaky tests up to 3 times
- Generate JUnit report
- Fail fast on critical tests
Report results and any failures.
`, "qe-test-executor")
// Smart test selection
Task("Run affected tests", `
Analyze changes in PR #123 and:
- Identify affected test files
- Run only relevant tests
- Include integration tests for changed modules
- Report coverage delta
`, "qe-test-selector")
```
## Execution Strategies
### 1. Parallel Execution
```typescript
await testExecutor.runParallel({
suites: ['unit', 'integration'],
workers: 4,
distribution: 'by-file', // or 'by-test', 'by-duration'
isolation: 'process',
sharding: {
enabled: true,
total: 4,
index: process.env.SHARD_INDEX
}
});
```
### 2. Smart Test Selection
```typescript
await testExecutor.runAffected({
changes: gitChanges,
selection: {
direct: true, // Tests for changed files
transitive: true, // Tests for dependents
integration: true // Integration tests touching changed code
},
fallback: 'full-suite' // If analysis fails
});
```
### 3. Flaky Test Handling
```typescript
await testExecutor.handleFlaky({
detection: {
enabled: true,
threshold: 0.1, // 10% flake rate
window: 100 // Last 100 runs
},
strategy: {
retry: 3,
quarantine: true,
notify: ['#flaky-tests']
}
});
```
## Execution Configuration
```yaml
execution:
parallel:
workers: auto # CPU cores - 1
timeout: 30000
bail: false
retry:
count: 2
delay: 1000
only_failed: true
reporting:
formats: [junit, json, html]
include_timing: true
include_logs: true
environments:
- name: node-18
image: node:18-alpine
- name: node-20
image: node:20-alpine
```
## CI/CD Integration
```yaml
# GitHub Actions example
test:
runs-on: ubuntu-latest
strategy:
matrix:
shard: [1, 2, 3, 4]
steps:
- uses: actions/checkout@v4
- name: Run tests
run: |
aqe test run \
--shard ${{ matrix.shard }}/4 \
--parallel \
--report junit
- name: Upload results
uses: actions/upload-artifact@v4
with:
name: test-results-${{ matrix.shard }}
path: reports/
```
## Result Aggregation
```typescript
interface ExecutionResults {
summary: {
total: number;
passed: number;
failed: number;
skipped: number;
flaky: number;
duration: number;
};
shards: ShardResult[];
failures: TestFailure[];
flakyTests: FlakyTest[];
coverage: CoverageReport;
timing: TimingAnalysis;
}
```
## Gotchas
- Full test suites may OOM in containers — the rule "don't run full suite" was violated 20x despite being in CLAUDE.md. Fix: make suite lightweight, don't just add more rules
- Fewer focused agents (3-4) outperform many vague ones (6-8) — always include verification command in each agent prompt
- New model releases can shift agent behavior mid-sprint — rules followed yesterday may be ignored today after model update
- Running all tests in parallel can mask flaky tests — use `--workers=1` for initial diagnosis
- Session crashes lose all context — save intermediate results to disk, not just memory
## Coordination
**Primary Agents**: qe-test-executor, qe-test-selector, qe-flaky-detector
**Coordinator**: qe-test-execution-coordinator
**Related Skills**: qe-test-generation, qe-coverage-analysis
© proffesor-for-testing · MIT · proffesor-for-testing/agentic-qe