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

cqrs-and-handlers — скилл для Claude Code: что делает и как установить

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

MIT ★ 234 обновлён 2026-10-05

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add dev-toolings/superpowers-symfony --skill cqrs-and-handlers -a claude-code
Открыть на GitHub

Что делает cqrs-and-handlers

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

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

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

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

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

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

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

Как установить cqrs-and-handlers

1Через Skills CLI (Vercel)

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/

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

Вопросы о cqrs-and-handlers

Как установить cqrs-and-handlers в Claude Code?

Выполните команду npx skills add dev-toolings/superpowers-symfony --skill cqrs-and-handlers -a claude-code в терминале проекта.

Что делает этот скилл?

Он задаёт пошаговый процесс реализации CQRS в Symfony через компонент Messenger, следит за разделением шин чтения и записи и генерирует тесты.

Какие ограничения накладываются на команды и запросы?

Команда не должна возвращать данные, кроме идентификатора созданной сущности. Запросы обязаны работать без побочных эффектов, а один класс сообщения обслуживается ровно одним хэндлером.

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

SKILL.md · MIT
---
name: cqrs-and-handlers
description: Implement CQRS in Symfony with separate Command and Query buses/handlers using the Messenger component
capabilities: [read, search]
tags: [architecture, messenger]
# projected by `bun run build` — do not edit by hand
allowed-tools:
  - Read
  - Glob
  - Grep
---

# Cqrs And Handlers (Symfony)

## Use when
- Separating writes from reads with distinct command and query buses.
- A service both changes state and returns data for display.
- Adding a use case as a command or a query with its own handler.

## Default workflow
1. Name the use case: a command changes state, a query returns data.
2. Write the message as a readonly class and exactly one handler for it.
3. Configure separate command and query buses; give the command bus the `validation` and `doctrine_transaction` middleware.
4. Inject the buses behind small interfaces, or the native buses with `#[Target]`.
5. Dispatch from a thin controller and return the query result or the new id.

## Guardrails
- Commands return nothing, or at most the id they created.
- Queries have no side effects, so they can be cached and retried.
- One handler per message; no handler dispatches back onto the bus it serves.
- Read models for complex queries are optional: add them when a query outgrows the entities.

## Progressive disclosure
- Use this file for execution posture and risk controls.
- Open references when deep implementation details are needed.

## Output contract
- Commands, queries and their handlers.
- The bus configuration and its middleware.
- Handler tests, and a functional test through the controller.

## References
- `reference.md`

© dev-toolings · MIT · dev-toolings/superpowers-symfony

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

Все скиллы по теме «Бэкенд и API» →
cqrs-implementation Seth Hobson Скилл cqrs-implementation для Claude Code, Codex и Cursor, который реализует паттерн CQRS: разделяет модели чтения и записи, настраивает обработчики команд и проекторы. CX Codex +1 11 000установок symfony-specialist VoltAgent Community Субагент symfony-specialist для Claude, который ведёт разработку на Symfony 6.4, 7.x и 8.0: сущности Doctrine, асинхронная обработка через Messenger, ресурсы API Platform. CX Codex ★ 26 718звёзд репо clean-architecture Giuseppe Trisciuoglio Скилл clean-architecture раскладывает PHP-проект на слои Domain, Application, Adapter и Infrastructure и даёт шаблоны сущностей, value objects и портов без привязки к Symfony. CX Codex +1 ★ 372звёзд репо php-pro https://github.com/Jeffallan Скилл php-pro задаёт правила разработки на PHP 8.3+ для Laravel и Symfony: включает strict_types, анализ в PHPStan на уровне 9 и тесты PHPUnit или Pest. CX Codex +1 16 400установок aws-lambda-php-integration giuseppe-trisciuoglio Скилл aws-lambda-php-integration подсказывает агенту, как развернуть PHP или Symfony на AWS Lambda через Bref: обработчики, слои рантайма, триггеры SQS/SNS и холодный старт. CX Codex +1 3 700установок sentry-php-sdk getsentry Скилл sentry-php-sdk помогает настроить мониторинг Sentry в проектах на чистом PHP, Laravel или Symfony. Распознаёт фреймворк, очереди и планировщики, после чего предлагает нужные пакеты и конфигурацию. CX Codex +1 2 400установок

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

Весь набор →
effective-context Скилл effective-context учит агента собирать контекст для Symfony-разработки: версии, файлы на пути ошибки, стектрейсы и ограничения проекта. CX Codex +1 ★ 234звёзд репо strategy-pattern Скилл strategy-pattern для Claude Code внедряет паттерн «Стратегия» в приложениях на Symfony с помощью тегированных сервисов. Обрабатывает растущий список алгоритмов или провайдеров. CX Codex +1 ★ 234звёзд репо executing-plans Скилл executing-plans для Claude Code ведёт по утверждённому плану реализации — от проверки тестов до отдельных коммитов по каждому шагу. Продолжает многоэтапную работу после перерыва. CX Codex +1 ★ 234звёзд репо twig-components Собирает переиспользуемые компоненты на Symfony UX Twig Components: props, слоты, анонимные шаблоны и CVA-варианты. Использует один и тот же фрагмент Twig на разных страницах. CX Codex +1 ★ 234звёзд репо daily-workflow Скилл daily-workflow для Claude Code и Codex задаёт порядок повседневной работы с Symfony — от запуска проекта до проверки изменений перед коммитом. Охватывает миграции, отладку и рутинные задачи. CX Codex +1 ★ 234звёзд репо bootstrap-check Скилл bootstrap-check проверяет конфигурацию Symfony-проекта перед работой: .env, сервисы, Doctrine, роуты. Показывает, что сломано, и чем это чинить. CX Codex +1 ★ 234звёзд репо ports-and-adapters Скилл ports-and-adapters помогает внедрить гексагональную архитектуру в проектах на Symfony, отделяя чистую доменную логику от Doctrine и внешних библиотек. CX Codex +1 ★ 234звёзд репо config-env-parameters Скилл config-env-parameters для Claude Code помогает менять переменные окружения, параметры и секреты Symfony с учётом разных сред. Задаёт значения и внедряет их в приложение. CX Codex +1 ★ 234звёзд репо

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

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