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

qe-requirements-validation — скилл для Claude Code

Скилл qe-requirements-validation для Claude Code проверяет тестируемость критериев приёмки, связывает требования с тест-кейсами и генерирует BDD-сценарии из пользовательских историй. Проверяет полноту требований до разработки.

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

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

Что делает qe-requirements-validation

Скилл работает с требованиями на разных уровнях: парсит критерии приёмки прямо из Jira, строит матрицу трассировки между историями и тестами, генерирует Gherkin-сценарии для каждой истории. Внутри есть проверка по методике SMART (Specific, Measurable, Achievable, Relevant, Testable), поиск пропусков в edge cases и обнаружение неприкрытых требований.

Матрица трассировки показывает, какие тесты связаны с каким требованием, находит orphan-тесты (без привязки к требованию) и считает процент покрытия. BDD-генератор создаёт feature-файлы с happy path, edge cases и error scenarios, может сгенерировать скелет step definitions.

Скилл работает с несколькими источниками: проекты Jira, локальные файлы требований и тестов, документация в Markdown. Требует доступа к исходникам (тесты и код должны быть в репозитории), иначе трассировка не будет полной.

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

  • проверить критерии приёмки на тестируемость перед спринтом
  • построить матрицу трассировки требований к тест-кейсам
  • сгенерировать BDD-сценарии из пользовательских историй
  • найти непокрытые требования и orphan-тесты
  • оценить полноту требований перед разработкой

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

  • Проверь критерии приёмки истории US-123 на тестируемость
  • Построй матрицу трассировки для текущего спринта, укажи пропуски в покрытии
  • Сгенерируй BDD-сценарии для истории «Регистрация пользователя»

Как установить qe-requirements-validation

1Через Skills CLI (Vercel)

npx skills add proffesor-for-testing/agentic-qe --skill qe-requirements-validation -a claude-code

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

~/.claude/skills/qe-requirements-validation/SKILL.md

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

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

Вопросы о qe-requirements-validation

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

Запусти команду npx skills add proffesor-for-testing/agentic-qe --skill qe-requirements-validation -a claude-code, а затем открой файл ~/.claude/skills/qe-requirements-validation/SKILL.md для проверки конфигурации.

Что делает qe-requirements-validation?

Скилл валидирует критерии приёмки, проверяя их на соответствие методике SMART и тестируемость; строит матрицу трассировки между требованиями и тестами; генерирует BDD-сценарии в формате Gherkin; находит пропуски в требованиях и непокрытые функции.

Какие источники требований поддерживает скилл?

Скилл работает с проектами Jira (извлекает истории и критерии), локальными файлами требований и тестов, документацией в Markdown. Для построения матрицы трассировки нужны актуальные исходники с кодом тестов.

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

SKILL.md · MIT
---
name: "qe-requirements-validation"
description: "Validates acceptance criteria for testability, traces requirements to test cases, and generates BDD scenarios from user stories. Use when validating acceptance criteria, building requirements traceability matrices, managing Gherkin scenarios, or ensuring complete requirements coverage before development."
trust_tier: 3
validation:
  schema_path: schemas/output.json
  validator_path: scripts/validate-config.json
  eval_path: evals/qe-requirements-validation.yaml
---

# QE Requirements Validation

## Purpose

Guide the use of v3's requirements validation capabilities including acceptance criteria parsing, requirements traceability, BDD scenario generation, and coverage gap identification.

## Activation

- When validating requirements
- When tracing requirements to tests
- When generating BDD scenarios
- When assessing requirements coverage
- When reviewing acceptance criteria

## Quick Start

```bash
# Parse acceptance criteria
aqe requirements parse --source jira --project MYAPP

# Build traceability matrix
aqe requirements trace --requirements reqs/ --tests tests/

# Generate BDD scenarios
aqe requirements bdd --story US-123 --output features/

# Check requirements coverage
aqe requirements coverage --sprint current
```

## Agent Workflow

```typescript
// Requirements validation
Task("Validate acceptance criteria", `
  Review acceptance criteria for sprint stories:
  - Check SMART criteria (Specific, Measurable, Achievable, Relevant, Testable)
  - Identify ambiguous requirements
  - Flag missing edge cases
  - Suggest improvements
`, "qe-acceptance-criteria")

// Traceability matrix
Task("Build traceability", `
  Create requirements traceability matrix:
  - Map user stories to test cases
  - Identify untested requirements
  - Find orphan tests (no linked requirement)
  - Calculate coverage metrics
`, "qe-traceability-builder")
```

## Requirements Operations

### 1. Acceptance Criteria Validation

```typescript
await acceptanceCriteria.validate({
  source: {
    type: 'jira',
    project: 'MYAPP',
    stories: 'sprint=current'
  },
  validation: {
    specific: true,
    measurable: true,
    achievable: true,
    relevant: true,
    testable: true
  },
  output: {
    score: true,
    issues: true,
    suggestions: true
  }
});
```

### 2. Traceability Matrix

```typescript
await traceabilityBuilder.build({
  requirements: {
    source: 'jira',
    types: ['story', 'task', 'bug']
  },
  artifacts: {
    tests: 'tests/**/*.test.ts',
    code: 'src/**/*.ts',
    documentation: 'docs/**/*.md'
  },
  output: {
    matrix: true,
    coverage: true,
    gaps: true,
    orphans: true
  }
});
```

### 3. BDD Scenario Generation

```typescript
await bddGenerator.generate({
  requirements: userStory,
  format: 'gherkin',
  scenarios: {
    happyPath: true,
    edgeCases: true,
    errorCases: true,
    dataVariations: true
  },
  output: {
    featureFile: true,
    stepDefinitions: 'skeleton'
  }
});
```

### 4. Coverage Analysis

```typescript
await requirementsCoverage.analyze({
  scope: 'sprint-23',
  metrics: {
    requirementsCovered: true,
    testCasesCoverage: true,
    automationCoverage: true,
    riskAssessment: true
  },
  report: {
    summary: true,
    details: true,
    recommendations: true
  }
});
```

## Traceability Matrix

```typescript
interface TraceabilityMatrix {
  requirements: {
    id: string;
    title: string;
    type: string;
    priority: string;
    status: string;
    linkedTests: string[];
    linkedCode: string[];
    coverage: 'full' | 'partial' | 'none';
  }[];
  tests: {
    id: string;
    name: string;
    type: 'unit' | 'integration' | 'e2e';
    linkedRequirements: string[];
    automated: boolean;
  }[];
  coverage: {
    requirementsCovered: number;
    requirementsPartial: number;
    requirementsUncovered: number;
    orphanTests: number;
  };
  gaps: {
    requirement: string;
    missingCoverage: string[];
    risk: 'high' | 'medium' | 'low';
  }[];
}
```

## BDD Integration

```gherkin
# Generated feature file
Feature: User Registration
  As a new user
  I want to create an account
  So that I can access the platform

  @happy-path
  Scenario: Successful registration with valid details
    Given I am on the registration page
    When I enter valid email "[email protected]"
    And I enter valid password "SecurePass123!"
    And I click the register button
    Then I should see a success message
    And I should receive a confirmation email

  @edge-case
  Scenario: Registration with existing email
    Given a user exists with email "[email protected]"
    When I try to register with email "[email protected]"
    Then I should see an error "Email already registered"
```

## Requirements Quality

```yaml
quality_checks:
  acceptance_criteria:
    has_given_when_then: preferred
    is_testable: required
    is_measurable: required
    no_ambiguity: required

  user_story:
    follows_template: "As a <role>, I want <feature>, so that <benefit>"
    has_acceptance_criteria: required
    estimated: preferred

  completeness:
    edge_cases_identified: required
    error_scenarios_covered: required
    non_functional_considered: preferred
```

## Sprint Integration

```typescript
await requirementsValidator.sprintReview({
  sprint: 'current',
  checks: {
    storiesComplete: true,
    criteriaValidated: true,
    testsLinked: true,
    coverageAdequate: true
  },
  gates: {
    minCoverage: 80,
    maxUntested: 2,
    requireDemo: true
  }
});
```

## Coordination

**Primary Agents**: qe-acceptance-criteria, qe-traceability-builder, qe-bdd-specialist
**Coordinator**: qe-requirements-coordinator
**Related Skills**: qe-test-generation, qe-quality-assessment

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

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

Все скиллы по теме «Тесты и QA» →
requirements-author microsoft Скилл requirements-author для создания и управления бизнес-требованиями (BRD) и продуктовыми требованиями (PRD) через три фазы: Discover, Define, Govern. Работает с канонические шаблонами и контрактами передачи между этапами. CX Codex +1 ★ 1 627звёзд репо cucumber-best-practices TheBushidoCollective Скилл cucumber-best-practices обучает ИИ-агента писать декларативные BDD-сценарии в Cucumber, избегать технического мусора в Gherkin и делить связанные тесты. Пригодится при рефакторинге автотестов. CX Codex +1 154установок 058-design-bdd Juan Antonio Breña Moral Скилл 058-design-bdd проводит Java-команду через Behavior-Driven Development как практику совместного открытия. Работает с проверенными фактами о поведении, конкретными примерами и сценариями на общем языке команды. CX Codex +1 135установок distill kirkchen Скилл distill извлекает BDD-спеки из существующего кода и создаёт черновики Gherkin-файлов .feature. Скилл подключается при переносе готового модуля в workflow Beat. CX Codex +1 533установок behavior-driven-development FradSer Скилл behavior-driven-development задаёт BDD-процесс для фич, исправлений и тестов: сначала сценарий и падающий тест, затем код. CX Codex +1 151установок add-cucumber-tests Decathlon Скилл add-cucumber-tests превращает функциональную спецификацию в .feature-файлы Cucumber, опираясь на реальные step definitions из Tzatziki. Пригодится в Java/Spring-проектах, где уже есть зависимости Tzatziki или Cucumber. CX Codex +1 1 100установок

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

Весь набор →
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-test-generation Скилл qe-test-generation для Claude Code создаёт тесты для нового и изменённого кода, включая проверки инвариантов и контрактов. Помогает находить пробелы в покрытии и переносить тесты между фреймворками. CX Codex +1 142установок 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установок sherlock-review Скилл sherlock-review собирает доказательства и проверяет утверждения об изменениях кода. Помогает найти причину ошибки или подтвердить исправление. CX Codex +1 135установок

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

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