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

qa-expert · zhaono1 — скилл для Claude Code: стратегия тестирования и quality

Скилл для планирования тестового покрытия и настройки quality gates. Пригодится, когда нужно разложить проверки по уровням риска и стадиям CI.

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

Что делает qa-expert

Скилл включается, когда вы просите стратегию QA, планируете покрытие тестами или настраиваете контроль качества. Внутри — подход на основе риска: критичные участки вроде денег, безопасности и данных требуют детерминированного покрытия, а второстепенные функции можно закрыть только юнит-тестами. Пропорции портфеля тестов (E2E, интеграционные, юниты) даны как пример, а не как обязательная норма — их предлагается выводить из архитектуры репозитория и стоимости отказа.

Отдельный блок — quality gates по стадиям: pre-commit (линт, формат, типы, юнит-тесты), pre-merge (все тесты, порог покрытия, npm audit, проверка лицензий) и pre-production (полный прогон, E2E, производительность, аудит безопасности). Есть шаблоны тест-плана и баг-репорта, метрики дефектов и тестов, правила автоматизации. Метрики вроде покрытия выше 80% и нуля flaky-тестов помечены как иллюстративные: скилл советует сначала взять существующие гейты проекта, а если их нет — зафиксировать базовую линию и согласовать цели с владельцем.

Два скрипта на Python: scripts/generate_test_plan.py собирает тест-план в docs/test-plan.md, scripts/coverage_analysis.py разбирает покрытие сервиса. Для запуска нужен Python 3. Скилл умеет читать и править файлы, гонять Bash, искать по коду и ходить в веб — то есть может сам открыть репозиторий и посмотреть, какие проверки там уже есть.

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

  • разложить тесты по уровням риска и стоимости отказа
  • собрать quality gates для pre-commit, pre-merge и pre-production
  • сгенерировать тест-план по шаблону в markdown
  • посчитать покрытие сервиса и записать разбор в файл
  • описать баг так, чтобы его воспроизвели с первого раза

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

  • Составь QA-стратегию для сервиса оплаты: какие тесты нужны на каждом уровне риска
  • Настрой quality gates для pre-merge: тесты, покрытие, npm audit
  • Сгенерируй тест-план для модуля авторизации в docs/test-plan.md

Как установить qa-expert

1Через Skills CLI (Vercel)

npx skills add zhaono1/agent-playbook --skill qa-expert -a claude-code

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

~/.claude/skills/qa-expert/SKILL.md

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

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

Вопросы о qa-expert

Как установить qa-expert в Claude?

Выполните npx skills add zhaono1/agent-playbook --skill qa-expert -a claude-code. Скилл появится в ~/.claude/skills/qa-expert/SKILL.md.

Что делает qa-expert?

Помогает планировать тестовое покрытие, настраивать quality gates и выбирать, что автоматизировать. Опирается на риск: критичные участки тестируются плотнее, второстепенные — легче.

Какие инструменты доступны скиллу?

Read, Write, Edit, Bash, Grep, Glob, WebFetch и WebSearch. Поэтому он может прочитать ваш репозиторий, запустить команды проверок и посмотреть внешние источники.

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

SKILL.md · MIT
---
name: qa-expert
description: Quality assurance expert for testing strategies and quality gates. Use when planning test coverage, setting up QA processes, or improving quality standards.
allowed-tools: Read, Write, Edit, Bash, Grep, Glob, WebFetch, WebSearch
metadata:
  hooks:
    after_complete:
      - trigger: session-logger
        mode: auto
        reason: "Log QA activity"
---

# QA Expert

Quality assurance specialist for developing comprehensive testing strategies and quality gates.

## When This Skill Activates

Activates when you:
- Ask for QA strategy
- Need quality gates
- Want to improve test coverage
- Plan testing approach

## Quality Assurance Strategy

### 1. Risk-Based Testing

Prioritize testing based on business impact, likelihood, change surface, and
existing production evidence. The approaches below are examples to tailor, not
universal requirements:

| Risk Level | Testing Approach |
|------------|------------------|
| **Critical** (Money, Security, Data) | Strong deterministic coverage; add resilience testing when the system supports it |
| **High** (Core features) | Full E2E, integration, unit |
| **Medium** (Secondary features) | Integration, unit |
| **Low** (Edge features) | Unit tests only |

### 2. Testing Portfolio

Choose the mix from system boundaries and failure cost. Do not enforce a fixed
ratio when a repository's architecture or existing test strategy indicates a
different shape.

| Level | Example Starting Mix | Focus |
|-------|------------|-------|
| E2E | 10% | Critical user journeys |
| Integration | 30% | API interactions |
| Unit | 60% | Business logic, utilities |

Treat this table as an illustration only. Derive the actual portfolio from the
repository's architecture, risk profile, SLOs, and existing quality gates.

### 3. Quality Gates

#### Pre-Commit
```bash
- Lint: npm run lint
- Format check: npm run format:check
- Type check: npm run type-check
- Unit tests: npm run test:unit
```

#### Pre-Merge
```bash
- All tests: npm test
- Coverage threshold: use the repository gate or agree a risk-based target
- Security scan: npm audit
- License check: npm run check:licenses
```

#### Pre-Production
```bash
- Full test suite: npm run test:all
- E2E tests: npm run test:e2e
- Performance tests: npm run test:perf
- Security audit: npm audit --audit-level high
```

## Test Categories

### Functional Testing

**Purpose**: Verify features work as specified

- Happy path testing
- Edge case testing
- Boundary value analysis
- Error handling

### Non-Functional Testing

**Performance**
- Derive latency and throughput targets from the current SLO, baseline, workload, and user journey
- Memory usage stable
- No memory leaks

**Security**
- OWASP Top 10 coverage
- Penetration testing
- Dependency vulnerability scan
- Secrets detection

**Compatibility**
- Browser testing (Chrome, Firefox, Safari, Edge)
- Device testing (Mobile, Desktop, Tablet)
- OS testing (Windows, macOS, Linux)
- Version testing (N-1 browser versions)

### Regression Testing

- Previous bugs don't reappear
- New features don't break existing features
- Performance doesn't degrade

### Exploratory Testing

- Find unexpected issues
- Test edge cases
- User experience issues

## Test Planning

### Test Plan Template

```markdown
# Test Plan: [Feature Name]

## Overview
[Feature description]

## Scope
[In scope / Out of scope]

## Test Cases

### Functional
- [ ] TC001: [Description]
- [ ] TC002: [Description]

### Integration
- [ ] TC101: [Description]

### E2E
- [ ] TC201: [Description]

## Test Data
[Required test data]

## Environment
[Test environment setup]

## Schedule
[Testing timeline]

## Exit Criteria
[Definition of done]
```

## Quality Metrics

Use existing project gates first. If none exist, establish a baseline and agree
targets with the owner; the values below are illustrative examples, not default
acceptance criteria.

### Code Quality
- **Test Coverage**: > 80%
- **Cyclomatic Complexity**: < 10 per function
- **Code Duplication**: < 5%
- **Technical Debt Ratio**: < 5%

### Defect Metrics
- **Defect Density**: < 1 defect per 1000 LOC
- **Critical Defects**: 0
- **High Defects**: 0
- **Medium Defects**: < 3

### Test Metrics
- **Test Pass Rate**: > 95%
- **Flaky Tests**: 0
- **Test Execution Time**: < 10 minutes

## Automation Strategy

### Automate When
- Test is run frequently
- Test has deterministic results
- Test is stable
- ROI justifies automation cost

### Don't Automate When
- Test requires human judgment
- Test is exploratory
- Test is one-time only
- Test changes frequently

## Bug Report Template

```markdown
## Bug Summary
[One-line summary]

## Severity
Critical / High / Medium / Low

## Steps to Reproduce
1.
2.
3.

## Expected Behavior
[What should happen]

## Actual Behavior
[What actually happens]

## Environment
- OS:
- Browser:
- Version:

## Attachments
[Screenshots, logs, etc.]
```

## Scripts

Generate test plan:
```bash
python3 scripts/generate_test_plan.py --name <feature> --output docs/test-plan.md
```

Analyze test coverage:
```bash
python3 scripts/coverage_analysis.py --name <service-name> --output coverage-analysis.md
```

## References

- `references/strategy.md` - Testing strategies
- `references/gates.md` - Quality gate definitions
- `references/metrics.md` - QA metrics and KPIs

© zhaono1 · MIT · zhaono1/agent-playbook

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

Всё по теме «Тесты и QA» →

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

qa-expert daymade Разворачивает в проекте структуру QA: тест-стратегию, тест-кейсы по AAA, трекинг багов P0–P4 и отчёты о прогрессе. CX Codex +1 2 000установок qa-metrics kindlmann Скилл задаёт формулы, цели и владельцев для метрик тестов: покрытие, флаки, escape rate, MTTR. Полезен, когда дашборд есть, а решений по нему нет. CX Codex +1 1 100установок constraint-driven-development addyosmani Записывает планку качества проекта в CONSTRAINTS.md с числами и следит, чтобы агент её не занижал: не глушил проверки, не удалял тесты. CX Codex +1 33 400установок test-strategy kindlmann Собирает документ по стратегии тестирования на несколько кварталов: уровни тестов, критерии входа и выхода, KPI качества. Пригодится, когда пора описать подход к QA, а не отдельный релиз. CX Codex +1 1 500установок test-flakiness Donchitos Скилл находит нестабильные тесты в логах CI игровых движков, считает долю сбоев и отправляет проблемные проверки на карантин. CX Codex +1 408установок qa-engineering-best-practices официальный github Правило для GitHub Copilot с набором инструкций по тестированию: пирамида тестов, именование, ассерты, баг-репорты. Пригодится, когда Copilot пишет тесты в вашем проекте. ★ 40 418звёзд репо tdd-gate davila7 Хук блокирует правку production-файлов, пока рядом нет теста. Пригодится, если хотите удержать TDD в работе с агентом. 192установок

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

skill-router Разбирает запрос и предлагает самый узкий подходящий скилл из каталога. Пригодится, когда непонятно, какой инструмент взять под задачу. CX Codex +1 873установок workflow-orchestrator Скилл ловит момент, когда другой скилл закончил работу, и решает, что запускать дальше: логирование сессии, разбор ошибок или захват кандидата на самоулучшение. CX Codex +1 833установок prd-planner Ведёт создание PRD и технического дизайна через четыре файла в docs/, чтобы агент не терял контекст между шагами. CX Codex +1 829установок test-automator Помогает писать юнит-, интеграционные и E2E-тесты, поднимать фреймворк и считать покрытие. Пригодится, когда тестов в проекте мало или они разъехались. CX Codex +1 812установок refactoring-specialist Скилл ведёт агента по шагам рефакторинга: находит запахи кода, предлагает технику и следит, чтобы тесты остались зелёными. CX Codex +1 747установок debugger Скилл ведёт агента по методике отладки: воспроизвести баг, сузить область, найти причину, починить и закрыть регрессионным тестом. CX Codex +1 745установок session-logger Сохраняет короткую сводку разговора с агентом: что решили, какие файлы трогали, что осталось открытым. Пригодится, когда нужно вернуться к работе позже. CX Codex +1 743установок api-documenter Скилл для описания REST и GraphQL API в формате OpenAPI/Swagger. Пригодится, когда нужно превратить россыпь эндпоинтов в читаемую спецификацию. CX Codex +1 717установок

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

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