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

bdd-scenarios — скилл для Claude Code: сценарии BDD и установка

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

Apache-2.0 180 установок ★ 201 обновлён 2026-09-08

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

Что делает bdd-scenarios

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

В рекомендациях есть порядок работы: начать с основного сценария, затем проверить крайние случаи и организовать сценарии тегами. Каждый сценарий лучше держать коротким и независимым от других. Это помогает заметить пробелы в требованиях до реализации; сами сценарии стоит обсуждать с заинтересованными сторонами.

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

  • описать критерии приёмки для пользовательской истории
  • зафиксировать ожидаемое поведение системы
  • добавить сценарии для ошибочных и пограничных случаев
  • сгруппировать сценарии тегами для фильтрации

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

  • Составь BDD-сценарии для этой пользовательской истории и добавь критерии приёмки.
  • Проверь сценарии регистрации: найди пропущенные крайние случаи и негативные проверки.
  • Разложи сценарии входа по тегам и отдели основной поток от проверки блокировки аккаунта.

Как установить bdd-scenarios

1Через Skills CLI (Vercel)

npx skills add TheBushidoCollective/han --skill bdd-scenarios -a claude-code

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

~/.claude/skills/bdd-scenarios/SKILL.md

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

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

Вопросы о bdd-scenarios

Как установить bdd-scenarios в Claude Code?

Выполните npx skills add TheBushidoCollective/han --skill bdd-scenarios -a claude-code. Файл скилла будет доступен по пути ~/.claude/skills/bdd-scenarios/SKILL.md.

Что делает скилл bdd-scenarios?

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

Как организовать сценарии с помощью bdd-scenarios?

Начните с основного сценария, затем добавьте пограничные случаи. Теги помогают группировать сценарии и фильтровать их.

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

SKILL.md · Apache-2.0
---
name: bdd-scenarios
description: Use when writing effective BDD scenarios including acceptance criteria, edge cases, and scenario organization. Use when defining behavior specifications.
allowed-tools:
  - Bash
  - Read
---

# BDD Scenarios

Learn to write clear, maintainable BDD scenarios that effectively capture business requirements and drive implementation.

## Writing Good Scenarios

A good scenario should be:

- **Specific**: Test one behavior
- **Declarative**: Describe what, not how
- **Business-focused**: Use domain language
- **Independent**: No dependencies on other scenarios

```gherkin
# Good scenario - specific and declarative
Scenario: Customer receives loyalty discount
  Given a customer with Gold membership status
  And a cart total of $100
  When the customer proceeds to checkout
  Then a 10% loyalty discount should be applied
  And the final total should be $90

# Bad scenario - too implementation-focused
Scenario: Apply discount
  Given I click the membership dropdown
  And I select "Gold" from the list
  When I click the checkout button
  Then the JavaScript calculates 10% off
```

## Acceptance Criteria Format

```gherkin
Feature: Order Refunds

  # Rule-based acceptance criteria
  Rule: Full refunds are available within 30 days

    Scenario: Refund requested within return window
      Given an order placed 15 days ago
      When the customer requests a refund
      Then a full refund should be processed

    Scenario: Refund requested after return window
      Given an order placed 45 days ago
      When the customer requests a refund
      Then the refund should be denied
      And the customer should see "Return window expired"
```

## Edge Case Scenarios

```gherkin
Feature: User Registration

  Scenario: Successful registration
    Given I am on the registration page
    When I submit valid registration details
    Then my account should be created

  # Edge cases
  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 "Email already registered"

  Scenario: Registration with invalid email format
    When I try to register with email "not-an-email"
    Then I should see "Please enter a valid email"

  Scenario: Registration with empty required fields
    When I submit the registration form with empty fields
    Then I should see validation errors for required fields
```

## Scenario Tags and Organization

```gherkin
@authentication @critical
Feature: User Login

  @smoke
  Scenario: Basic login flow
    # ...

  @security
  Scenario: Account lockout after failed attempts
    # ...

  @wip
  Scenario: Two-factor authentication
    # Work in progress
```

## When to Use This Skill

Use bdd-scenarios when you need to:

- Define acceptance criteria for user stories
- Document expected system behavior
- Create comprehensive test coverage
- Identify edge cases early in development
- Communicate requirements clearly

## Best Practices

- Start with the happy path scenario
- Add edge cases systematically
- Use tags for organization and filtering
- Keep scenarios at 3-7 steps
- Write scenarios before implementation
- Review scenarios with stakeholders

## Common Pitfalls

- Writing scenarios after implementation
- Including too many steps per scenario
- Using vague or ambiguous language
- Forgetting negative test cases
- Not organizing with tags effectively

© TheBushidoCollective · Apache-2.0 · TheBushidoCollective/han

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

Все скиллы по теме «Тесты и QA» →
058-design-bdd Juan Antonio Breña Moral Скилл 058-design-bdd проводит Java-команду через Behavior-Driven Development как практику совместного открытия. Работает с проверенными фактами о поведении, конкретными примерами и сценариями на общем языке команды. CX Codex +1 135установок qa-planning WellApp-ai Скилл qa-planning собирает QA-контракт по фиче: нумерованные Gherkin-сценарии для источников данных и приёмочные критерии для фронтенда. Пригодится до начала реализации. CX Codex +1 1установок behavior-driven-development FradSer Скилл behavior-driven-development задаёт BDD-процесс для фич, исправлений и тестов: сначала сценарий и падающий тест, затем код. CX Codex +1 151установок gherkin-style-testing-cursorrules-prompt-file PatrickJS Правило gherkin-style-testing-cursorrules-prompt-file превращает технические тест-скрипты и ручные кейсы в Gherkin-сценарии на языке, понятном бизнесу и юристам. CX Codex +1 ★ 41 178звёзд репо serenity-bdd-skill TestMu AI serenity-bdd-skill — скилл для Claude Code, который создаёт BDD-тесты на Java с Serenity и паттерном Screenplay. Запускается при запросах о Serenity, @Steps или отчётах Serenity. CX Codex +1 223установок add-cucumber-tests Decathlon Скилл add-cucumber-tests превращает функциональную спецификацию в .feature-файлы Cucumber, опираясь на реальные step definitions из Tzatziki. Пригодится в Java/Spring-проектах, где уже есть зависимости Tzatziki или Cucumber. CX Codex +1 1 100установок

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

Весь набор →
react-native-web-testing Скилл react-native-web-testing помогает писать тесты для приложений на React Native Web с помощью Jest и React Native Testing Library. CX Codex +1 236установок tailwind-responsive-design Скилл tailwind-responsive-design помогает собирать адаптивные интерфейсы на Tailwind CSS: от mobile-first сеток до типографики и скрытия элементов по брейкпоинтам. CX Codex +1 235установок ansible-roles Скилл ansible-roles для Claude Code помогает разбить Ansible-автоматизацию на роли с понятной структурой. Организует задачи установки, настройки nginx и безопасности. CX Codex +1 234установок bdd-patterns Скилл bdd-patterns для Claude Code помогает писать BDD-спецификации, сценарии и критерии приёмки в формате Given–When–Then. Создаёт тесты, понятные разработчикам и бизнесу. CX Codex +1 211установок playwright-bdd-gherkin-syntax Скилл playwright-bdd-gherkin-syntax помогает составлять feature-файлы Gherkin для Playwright BDD с учётом сценариев, таблиц примеров и тегов. CX Codex +1 180установок storybook-component-documentation Скилл storybook-component-documentation генерирует документацию компонентов в Storybook через autodocs, MDX-страницы и JSDoc-комментарии. Пригодится при создании или обновлении доков для UI-библиотек. CX Codex +1 166установок sop-maintenance Скилл sop-maintenance для Claude Code обновляет, версионирует и выводит из эксплуатации стандартные операционные процедуры (SOP). Обновляет регламенты после смены стека. CX Codex +1 159установок cucumber-best-practices Скилл cucumber-best-practices обучает ИИ-агента писать декларативные BDD-сценарии в Cucumber, избегать технического мусора в Gherkin и делить связанные тесты. Пригодится при рефакторинге автотестов. CX Codex +1 154установок

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

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