cqrs-and-handlers — скилл для Claude Code: что делает и как установить
Скилл cqrs-and-handlers помогает внедрить CQRS в Symfony через Symfony Messenger с разделением шин команд и запросов.
MIT ★ 234 обновлён 2026-10-05
npx skills add dev-toolings/superpowers-symfony --skill cqrs-and-handlers -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/cqrs-and-handlers/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/cqrs-and-handlers/
1Через Skills CLI (Vercel)
npx skills add dev-toolings/superpowers-symfony --skill cqrs-and-handlers -a codex2Вручную: положить файлы
.agents/skills/cqrs-and-handlers/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add dev-toolings/superpowers-symfony --skill cqrs-and-handlers -a cursor2Вручную: положить файлы
.cursor/skills/cqrs-and-handlers/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install dev-toolings/superpowers-symfony content/skills/cqrs-and-handlers2Вручную: положить файлы
.github/skills/cqrs-and-handlers/SKILL.md1Через Skills CLI (Vercel)
npx skills add dev-toolings/superpowers-symfony --skill cqrs-and-handlers -a gemini-cli2Командой платформы
gemini skills install https://github.com/dev-toolings/superpowers-symfony --path content/skills/cqrs-and-handlersВручную: положить файлы
.devin/skills/cqrs-and-handlers/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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