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

requirement-review — скилл для Claude Code

Скилл requirement-review прогоняет документ требований до проектирования: ищет пробелы, противоречия и неизмеримые формулировки, ставит оценки и собирает отчёт.

MIT 129 установок ★ 18 обновлён 2026-01-23

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

Что делает requirement-review

Скилл проверяет требования по шести характеристикам: полнота, ясность, согласованность, проверяемость, трассируемость и осуществимость. Каждая получает балл от 0 до 100%.

Работа начинается со сбора материала: BRD или SRS, user stories, нефункциональные ограничения, матрица трассируемости, готовые критерии приёмки. Дальше каждое требование идёт по чек-листам и попадает в отчёт с исполнительным резюме, находками по серьёзности и задачами с владельцами и сроками. Чек-листы, примеры «до/после» и шаблоны отчёта лежат в файлах каталога references/.

Порог для продакшена — 90% и выше. 60–74% скилл считает поводом для существенной переработки, а ниже 60% советует переделать документ целиком. Находки ссылаются на ID требований, поэтому нумерацию стоит навести заранее: в отчёте по ненумерованному документу указывать будет не на что.

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

  • Проверить BRD на пробелы и незакрытые TBD до старта разработки
  • Найти противоречия между требованиями и вынести их на решение
  • Переписать размытые формулировки вроде «быстро» и «удобно» в измеримые критерии
  • Оценить бэклог user stories по INVEST и формату Given-When-Then
  • Сверить структуру SRS с IEEE 830

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

  • Проверь docs/BRD.md на полноту и ясность, собери отчёт с оценками по шести характеристикам.
  • Найди конфликты в требованиях к оплате и покажи их с ID.
  • Оцени бэклог user stories по INVEST и подскажи, где не хватает критериев приёмки.

Как установить requirement-review

1Через Skills CLI (Vercel)

npx skills add DauQuangThanh/hanoi-rainbow --skill requirement-review -a claude-code

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

~/.claude/skills/requirement-review/SKILL.md

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

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

Вопросы о requirement-review

Как установить requirement-review в Claude Code?

Выполните npx skills add DauQuangThanh/hanoi-rainbow --skill requirement-review -a claude-code. Скилл окажется в ~/.claude/skills/requirement-review/SKILL.md.

Что делает requirement-review?

Прогоняет документ требований по шести характеристикам качества и выдаёт отчёт: баллы, проблемы по серьёзности, задачи с владельцами и сроками и итоговую рекомендацию.

По каким стандартам он проверяет требования?

IEEE 830 для SRS, INVEST для user stories, ISO/IEC 25010 для модели качества. Отдельно есть отраслевые наборы: HIPAA, PCI-DSS, SOC 2, FDA.

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

SKILL.md · MIT
---
name: requirement-review
description: Conducts comprehensive requirements review including completeness validation, clarity assessment, consistency checking, testability evaluation, and standards compliance. Produces detailed review reports with findings, gaps, conflicts, and improvement recommendations. Use when reviewing requirements documents (BRD, SRS, user stories), validating acceptance criteria, assessing requirements quality, identifying gaps and conflicts, or ensuring standards compliance (IEEE 830, INVEST criteria). Trigger when users mention "review requirements", "validate requirements", "check requirements quality", "find requirement issues", or "assess BRD/SRS quality".
---

# Requirement Review

Systematically review requirements to validate quality and identify issues before design and development begins. Ensure requirements are complete, clear, consistent, testable, and traceable.

## Review Workflow

## 1. Preparation

Gather all relevant documentation:

- Requirements documents (BRD, SRS, user stories)
- Non-functional requirements and constraints
- Requirements Traceability Matrix (if available)
- Project context (charter, goals)
- Existing acceptance criteria

### 2. Quality Assessment

Evaluate each requirement using **six quality attributes**:

1. **Completeness**: All needs captured, no missing details or TBDs, dependencies identified
2. **Clarity**: Unambiguous, specific, no vague terms ("user-friendly", "fast", "easy")
3. **Consistency**: No conflicts, consistent terminology and priorities
4. **Testability**: Verifiable with measurable acceptance criteria and clear pass/fail
5. **Traceability**: Links to business goals, design, and tests
6. **Feasibility**: Technically achievable within constraints (budget, timeline, capability)

> **See [quality-checklists.md](references/quality-checklists.md)** for detailed assessment criteria and document-specific checklists

### 3. Issue Identification

Identify common requirement problems:

**Ambiguous**: "system shall be fast" → Specify measurable criteria: "< 2s response for 95% of requests"

**Untestable**: "system shall be secure" → Define specific controls: password complexity, encryption standards, audit logging

**Incomplete**: "system shall send notifications" → Specify channel, timing, content, recipients

**Conflicting**: REQ-012 "phone required" vs REQ-089 "phone optional" → Flag for stakeholder resolution

> **See [examples.md](references/examples.md)** for extensive before/after examples

### 4. Quality Scoring

Calculate scores for each quality attribute (0-100%):

- **90-100%**: Excellent - minimal issues
- **75-89%**: Good - minor improvements needed
- **60-74%**: Fair - notable gaps exist
- **Below 60%**: Poor - major rework required

**Overall Quality** = Average of all six attributes  
**Target**: ≥ 90% for production-readiness

### 5. Report Generation

Create structured review report with:

**Executive Summary**: Quality rating, recommendation, key strengths (2-3), critical issues (2-3), top actions

**Detailed Findings**: Quality scores, issues by severity (Critical/Major/Minor), specific examples with requirement IDs

**Action Items**: Prioritized list with owners, due dates, effort estimates, approval conditions

> **See [report-templates.md](references/report-templates.md)** for complete report structure and templates

### 6. Recommendations

Provide clear decision:

- **Approve**: Requirements ≥ 90% quality threshold
- **Approve with Conditions**: Critical issues must be resolved before design
- **Major Revision**: 60-74% quality - substantial rework required
- **Reject**: < 60% quality or fundamental issues - complete redesign needed

## Document-Specific Focus

### Business Requirements Documents (BRD)

Focus on business objectives, stakeholder needs, scope definition, business case, constraints

### Software Requirements Specifications (SRS)

Focus on functional requirements, non-functional requirements (performance, security, scalability), system behaviors, integration points, IEEE 830 compliance

### User Story Backlogs

Focus on INVEST criteria (Independent, Negotiable, Valuable, Estimable, Small, Testable), acceptance criteria format (Given-When-Then), story format, prioritization

> **See [quality-checklists.md](references/quality-checklists.md)** for document-specific assessment criteria

## Severity Definitions

- **Critical**: Blocks progress, must fix immediately (security gaps, fundamental conflicts, missing scope)
- **Major**: Significant quality impact, should fix before approval (ambiguous criteria, missing acceptance criteria)
- **Minor**: Quality improvements, nice to have (formatting, examples, enhancements)

## Common Anti-Patterns to Flag

- **Gold Plating**: Adding unrequested features
- **Solution-Focused**: Specifying "how" instead of "what" (requirements should be technology-agnostic)
- **Scope Creep**: Accepting changes without change control
- **Analysis Paralysis**: Over-perfecting requirements indefinitely
- **Weak Acceptance Criteria**: Vague or missing test conditions
- **No Traceability**: Requirements disconnected from business goals

## Vague Terms to Replace

Always replace with measurable criteria:

- "user-friendly", "intuitive", "easy" → Define usability metrics
- "fast", "quick", "responsive" → Specify response time targets
- "secure" → Define specific security controls
- "scalable" → Define capacity and load targets
- "reliable" → Define uptime percentage and recovery time

## Standards Compliance

- **IEEE 830**: SRS structure and content standards
- **INVEST**: User story quality criteria (Independent, Negotiable, Valuable, Estimable, Small, Testable)
- **ISO/IEC 25010**: Systems and software quality models
- **Industry-Specific**: HIPAA (healthcare), PCI-DSS (payments), SOC 2 (SaaS), FDA (medical devices)

> **See [quality-checklists.md](references/quality-checklists.md)** for standards compliance details

## Report Format

Generate review reports in this structure:

1. **Executive Summary** (1 page): Overall assessment, key findings, recommendation
2. **Quality Metrics** (0.5 page): Scores by attribute with targets
3. **Detailed Findings** (2-5 pages): Issues grouped by attribute with examples and recommendations
4. **Action Items** (1 page): Prioritized list with owners and due dates
5. **Approval Decision** (0.5 page): Recommendation with rationale and next steps

Keep reports factual, specific, and actionable. Always cite specific requirement IDs when identifying issues.

> **See [report-templates.md](references/report-templates.md)** for complete report templates

© DauQuangThanh · MIT · DauQuangThanh/hanoi-rainbow

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

Все скиллы по теме «Тексты и документация» →
plan-review mvschwarz Скилл plan-review оценивает спецификацию фичи с трёх сторон — стратегии, дизайна и инженерной реализуемости — ещё до начала разработки. Помогает найти пробелы в требованиях. CX Codex +1 ★ 8 928звёзд репо security-requirement-extraction Seth Hobson Скилл security-requirement-extraction для Claude Code, который превращает модели угроз и бизнес-контекст в конкретные требования безопасности. Запускается, когда нужно выписать security user stories, критерии приёмки или тест-кейсы. CX Codex +1 24 845установок requirements-author microsoft Скилл requirements-author для создания и управления бизнес-требованиями (BRD) и продуктовыми требованиями (PRD) через три фазы: Discover, Define, Govern. Работает с канонические шаблонами и контрактами передачи между этапами. CX Codex +1 ★ 1 627звёзд репо BRD Quality Reviewer microsoft Субагент BRD Quality Reviewer автоматически проверяет требования в BRD по стандартам ISO/IEC/IEEE 29148 и ISO/IEC 25010 и формирует отчёт с рекомендациями без изменения файлов. CX Codex +1 ★ 1 627звёзд репо requirements-review-gate gotalab Правило requirements-review-gate останавливает работу и требует отремонтировать черновик требований перед тем, как начать писать requirements.md. Проверяет полноту охвата, формат EARS и структуру. CX Codex +1 ★ 3 774звёзд репо feature-forge https://github.com/Jeffallan Скилл feature-forge проводит интервью по требованиям и превращает идею фичи в спецификацию: EARS-требования, критерии приёмки, чек-лист реализации. CX Codex +1 4 600установок

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

frontend-ui-ux-design Скилл frontend-ui-ux-design организует процесс проектирования интерфейсов: от сбора требований и вайрфреймов до проверки доступности по WCAG и спецификаций компонентов для фронтенда. CX Codex +1 541установок frontend-design-review Скилл frontend-design-review проверяет интерфейсы на соответствие дизайн-системе, контрастность WCAG 2.1 AA и адаптивность. Пригодится перед вёрсткой макетов из Figma или Sketch. CX Codex +1 463установок keycloak-administration Скилл keycloak-administration ведёт агента по настройке Keycloak: realms, клиенты, SSO, RBAC, федерация LDAP и разбор проблем со входом. CX Codex +1 336установок oracle-cloud Помогает проектировать архитектуру в Oracle Cloud Infrastructure, писать код для Terraform OCI и разворачивать базы данных или кластеры OKE. CX Codex +1 152установок backend-design Скилл backend-design выстраивает пошаговое проектирование бэкенда: от спецификаций API и схемы БД до модели авторизации и кэширования. Пригодится при старте нового сервиса или рефакторинге архитектуры. CX Codex +1 130установок

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

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