qe-requirements-validation — скилл для Claude Code
Скилл qe-requirements-validation для Claude Code проверяет тестируемость критериев приёмки, связывает требования с тест-кейсами и генерирует BDD-сценарии из пользовательских историй. Проверяет полноту требований до разработки.
MIT 141 установок ★ 533 обновлён 2026-10-25
npx skills add proffesor-for-testing/agentic-qe --skill qe-requirements-validation -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/qe-requirements-validation/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/qe-requirements-validation/
1Через Skills CLI (Vercel)
npx skills add proffesor-for-testing/agentic-qe --skill qe-requirements-validation -a codex2Вручную: положить файлы
.agents/skills/qe-requirements-validation/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add proffesor-for-testing/agentic-qe --skill qe-requirements-validation -a cursor2Вручную: положить файлы
.cursor/skills/qe-requirements-validation/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install proffesor-for-testing/agentic-qe assets/skills/qe-requirements-validation2Вручную: положить файлы
.github/skills/qe-requirements-validation/SKILL.md1Через Skills CLI (Vercel)
npx skills add proffesor-for-testing/agentic-qe --skill qe-requirements-validation -a gemini-cli2Командой платформы
gemini skills install https://github.com/proffesor-for-testing/agentic-qe --path assets/skills/qe-requirements-validationВручную: положить файлы
.devin/skills/qe-requirements-validation/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add proffesor-for-testing/agentic-qe --skill qe-requirements-validation -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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