# cqrs-and-handlers

Скилл cqrs-and-handlers помогает внедрить CQRS в Symfony через Symfony Messenger с разделением шин команд и запросов.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 234 у репозитория
- Автор: dev-toolings
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/dev-toolings/superpowers-symfony/tree/HEAD/content/skills/cqrs-and-handlers/SKILL.md
- Обновлён: 2026-10-05
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/cqrs-and-handlers

## Что делает

Скилл направляет Claude Code при проектировании архитектуры CQRS в проектах на Symfony. Он задаёт правила для сообщений и обработчиков: неизменяемые классы `readonly`, строго один хэндлер на каждое сообщение и запрет на повторную отправку сообщений в ту же шину изнутри обработчика.

Командная шина настраивается с middleware `validation` и `doctrine_transaction`, чтобы гарантировать валидацию и атомарность транзакций. Запросы проектируются без побочных эффектов, поэтому их результаты разрешено кэшировать. Команды либо ничего не возвращают, либо отдают только идентификатор созданной записи.

На выходе агент создаёт сообщения, обработчики, конфигурацию шин и тесты — юнит-тесты хэндлеров вместе с функциональным тестом контроллера.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add dev-toolings/superpowers-symfony --skill cqrs-and-handlers -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/cqrs-and-handlers/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/cqrs-and-handlers/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add dev-toolings/superpowers-symfony --skill cqrs-and-handlers -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/cqrs-and-handlers/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add dev-toolings/superpowers-symfony --skill cqrs-and-handlers -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/cqrs-and-handlers/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install dev-toolings/superpowers-symfony content/skills/cqrs-and-handlers
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/cqrs-and-handlers/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add dev-toolings/superpowers-symfony --skill cqrs-and-handlers -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/dev-toolings/superpowers-symfony --path content/skills/cqrs-and-handlers
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/cqrs-and-handlers/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/dev-toolings/superpowers-symfony/tree/HEAD/content/skills/cqrs-and-handlers/SKILL.md

## Когда брать
- разделить чтение и запись в Symfony на независимые шины
- создать команду с транзакционным обработчиком и валидацией
- настроить шину запросов без побочных эффектов
- написать тесты для хэндлеров и контроллеров Messenger

## Примеры запросов агенту
- Выдели создание заказа в команду и напиши для неё обработчик с сохранением в Doctrine
- Спроектируй запрос для получения профиля пользователя через Query Bus
- Настрой шины команд и запросов в Messenger с нужными middleware

## Похожие
- [cqrs-implementation](https://affpapa.org/nevibecode/skills/cqrs-implementation.md) — скилл · 11000 установок
- [symfony-specialist](https://affpapa.org/nevibecode/agents/symfony-specialist.md) — субагент · ★ 26718 у репозитория
- [clean-architecture](https://affpapa.org/nevibecode/skills/clean-architecture-2.md) — скилл · ★ 372 у репозитория
- [php-pro](https://affpapa.org/nevibecode/skills/httpsgithubcomjeffallan-php-pro.md) — скилл · 16400 установок
- [aws-lambda-php-integration](https://affpapa.org/nevibecode/skills/aws-lambda-php-integration.md) — скилл · 3700 установок
- [sentry-php-sdk](https://affpapa.org/nevibecode/skills/sentry-php-sdk.md) — скилл · 2400 установок

Из того же набора: [dev-toolings/superpowers-symfony](https://affpapa.org/nevibecode/by/dev-toolings/superpowers-symfony.md) — 51 карточка

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
