symfony-messenger — скилл для Claude Code: что делает и как установить
Скилл для работы с асинхронными сообщениями через Symfony Messenger: настройка транспортов, обработчиков и стратегий повтора.
MIT ★ 234 обновлён 2026-10-05
npx skills add dev-toolings/superpowers-symfony --skill symfony-messenger -a claude-codeЧто делает symfony-messenger
Скилл помогает выносить медленную или опасную работу из HTTP-запроса в очередь. Вы создаёте класс-сообщение с идентификаторами (не с сущностями Doctrine), пишете обработчик с атрибутом #[AsMessageHandler], маршрутизируете сообщение в транспорт (Doctrine, Redis, AMQP, sync:// или in-memory://) и запускаете воркер командой messenger:consume.
Обработчик должен быть идемпотентным: доставка сообщений гарантируется хотя бы один раз, повторный вызов не должен ломать данные. Скилл задаёт политику повторов, настройки транспорта ошибок и команды для проверки связности через debug:messenger и messenger:stats. Без перезапуска воркеров после деплоя (messenger:stop-workers) новый код не применится.
В тестах используйте транспорт in-memory://, чтобы проверить логику без внешних зависимостей. Для воркеров задавайте ограничения по памяти (--memory-limit), времени (--time-limit) или числу сообщений (--limit).
Какие задачи решает
- вынести медленную работу из HTTP-запроса в фоновый обработчик
- настроить транспорт для RabbitMQ, Redis или Doctrine и маршрутизацию сообщений
- написать идемпотентный обработчик, который безопасно переживёт повторную доставку
- задать стратегию повторов и транспорт для сообщений с ошибками
- проверить связность конфигурации и запустить воркер с ограничениями
Примеры запросов агенту
- Создай класс сообщения
SendInvoiceEmailс полямиorderIdиrecipientEmail, обработчик с#[AsMessageHandler]и маршрутизацию в транспортasyncчерез Doctrine. - Настрой
retry_strategyдля транспортаasync: три попытки с задержкой 5, 15, 60 секунд, и отправку вfailure_transportпосле исчерпания попыток. - Запусти воркер
messenger:consume async -vvс лимитом 100 сообщений и выведиdebug:messenger, чтобы проверить связность.
Как установить symfony-messenger
1Через Skills CLI (Vercel)
npx skills add dev-toolings/superpowers-symfony --skill symfony-messenger -a claude-code2Вручную: положить файлы
~/.claude/skills/symfony-messenger/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/symfony-messenger/
1Через Skills CLI (Vercel)
npx skills add dev-toolings/superpowers-symfony --skill symfony-messenger -a codex2Вручную: положить файлы
.agents/skills/symfony-messenger/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add dev-toolings/superpowers-symfony --skill symfony-messenger -a cursor2Вручную: положить файлы
.cursor/skills/symfony-messenger/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install dev-toolings/superpowers-symfony content/skills/symfony-messenger2Вручную: положить файлы
.github/skills/symfony-messenger/SKILL.md1Через Skills CLI (Vercel)
npx skills add dev-toolings/superpowers-symfony --skill symfony-messenger -a gemini-cli2Командой платформы
gemini skills install https://github.com/dev-toolings/superpowers-symfony --path content/skills/symfony-messengerВручную: положить файлы
.devin/skills/symfony-messenger/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о symfony-messenger
Как установить symfony-messenger в Claude Code?
Выполните npx skills add dev-toolings/superpowers-symfony --skill symfony-messenger -a claude-code, затем откройте файл ~/.claude/skills/symfony-messenger/SKILL.md.
Что делает symfony-messenger?
Скилл помогает работать с Symfony Messenger: создавать сообщения и обработчики, настраивать транспорты и стратегии повтора, запускать воркеры и проверять конфигурацию.
Почему нельзя передавать сущности Doctrine в сообщениях?
Прокси и отсоединённое состояние не сериализуются чисто. Передавайте идентификаторы и перезагружайте сущности в обработчике по ID.
Исходный текст
SKILL.md · MIT
---
name: symfony-messenger
description: Async message handling with Symfony Messenger; configure transports (RabbitMQ, Redis, Doctrine); implement handlers, middleware, and retry strategies
capabilities: [read, search, edit, shell]
tags: [messenger]
# projected by `bun run build` — do not edit by hand
allowed-tools:
- Read
- Glob
- Grep
- Write
- Edit
- Bash
---
# Symfony Messenger (Symfony)
## Use when
- Moving slow or failure-prone work out of the request into a message and an `#[AsMessageHandler]` handler.
- Choosing a transport (Doctrine, Redis, AMQP, `sync://`, `in-memory://`) and routing messages to it.
- Running, sizing, and restarting workers with `messenger:consume`.
- Making handlers safe under redelivery.
## Default workflow
1. Create the message as a plain `readonly` class that carries IDs, never entities.
2. Write the handler with `#[AsMessageHandler]` and a typed `__invoke()`: refetch by ID, skip work already done.
3. Route the message with `#[AsMessage('async')]` or the `routing` key, and declare the transport DSN in `messenger.yaml`.
4. Set `retry_strategy` and `failure_transport` on the transport.
5. Consume with `messenger:consume async -vv`, bounded by `--limit`, `--memory-limit`, or `--time-limit`.
6. Check the wiring with `debug:messenger` and `messenger:stats`, and use `in-memory://` in tests.
## Guardrails
- Pass entity IDs, never Doctrine entities: proxies and detached state do not serialize cleanly.
- Delivery is at-least-once: a redelivered message must return quietly, not throw.
- `PriorityStamp`, `--fetch-size`, `--no-reset`, and `stop_worker_on_signals` are marked 8.1+ in the reference: verify the minimum version first.
- Restart workers on deploy with `messenger:stop-workers`.
## Progressive disclosure
- Use this file for execution posture and risk controls.
- Open references when deep implementation details are needed.
## Output contract
- The message, its handler, and the routing and transport configuration.
- The retry and failure transport settings.
- The worker command, and the `debug:messenger` or `messenger:stats` output that proves the wiring.
## References
- `reference.md`
© dev-toolings · MIT · dev-toolings/superpowers-symfony