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

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

Скилл для работы с асинхронными сообщениями через Symfony Messenger: настройка транспортов, обработчиков и стратегий повтора.

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

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

Что делает 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-code

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

~/.claude/skills/symfony-messenger/SKILL.md

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

По шагам, с командами для каждой платформы: Как установить скилл в 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

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

Все скиллы по теме «Бэкенд и API» →
symfony-specialist VoltAgent Community Субагент symfony-specialist для Claude, который ведёт разработку на Symfony 6.4, 7.x и 8.0: сущности Doctrine, асинхронная обработка через Messenger, ресурсы API Platform. CX Codex ★ 26 718звёзд репо symfony-security-auditor reason-machines Скилл symfony-security-auditor ищет логические уязвимости и сбои контроля доступа в проектах на Symfony. Запускает двух агентов для взаимной проверки находок перед выдачей отчёта. CX Codex +1 239установок django-celery affaan-m Скилл django-celery для Claude Code настраивает фоновые задачи Django и воркеры Celery. Оформляет очереди Redis, планировщик Beat, обработку таймаутов и повторные попытки с бэкоффом. CX Codex +1 6 300установок aspire codewithmukesh Помогает настроить .NET Aspire для локального запуска сервисов, ресурсов и обнаружения сервисов. Нужен при работе с AppHost и общими настройками сервисов. CX Codex +1 4 000установок background-job-orchestrator curiositech Скилл background-job-orchestrator помогает настроить фоновые очереди на BullMQ или Celery. Переносит тяжёлые операции из обработчиков API, добавляет повторные попытки и защищает сервис от перегрузок. CX Codex +1 198установок php-symfony официальный github Правило php-symfony для GitHub Copilot, которое держит генерацию кода в рамках официальных практик Symfony. Применяется к PHP, YAML, XML и Twig-файлам, когда ИИ дописывает контроллеры, конфиги или шаблоны. CX Codex +1 ★ 41 430звёзд репо

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

Весь набор →
tdd-with-pest Скилл tdd-with-pest для Claude Code ведёт разработку в Symfony через RED-GREEN-REFACTOR с Pest v4. Создаёт тесты, воспроизводит баги и переносит PHPUnit-тесты на синтаксис Pest. CX Codex +1 ★ 234звёзд репо api-platform-versioning Скилл api-platform-versioning помогает менять API на API Platform без ломающих релизов: сначала депрекация с датой sunset, параллельные версии — в крайнем случае. CX Codex +1 ★ 234звёзд репо functional-tests Скилл functional-tests помогает писать функциональные тесты контроллеров и сервисов Symfony на базе WebTestCase, KernelTestCase и DAMA rollback. CX Codex +1 ★ 234звёзд репо doctrine-migrations Скилл doctrine-migrations помогает создавать и проверять миграции Doctrine, откатывать версии и готовить их к запуску в production. Пригодится при изменениях схемы Symfony-приложения. CX Codex +1 ★ 234звёзд репо api-platform-security Скилл api-platform-security настраивает правила доступа в Symfony API Platform через выражения security, воутеры и хуки жизненного цикла операций. CX Codex +1 ★ 234звёзд репо e2e-panther-playwright Скилл e2e-panther-playwright для Claude Code помогает писать E2E-тесты Symfony: Panther запускает реальный браузер, Playwright берёт сложные сценарии. Тесты проверяют поведение JavaScript, невидимое WebTestCase. CX Codex +1 ★ 234звёзд репо doctrine-relations Скилл doctrine-relations помогает настроить связи между сущностями Doctrine (OneToMany, ManyToMany, ManyToOne) с правильным выбором сторон, каскадными операциями и защитой от N+1 запросов. CX Codex +1 ★ 234звёзд репо doctrine-fetch-modes Скилл doctrine-fetch-modes помогает настроить выборку данных в Doctrine ORM и DBAL 4 для Symfony: устраняет проблему N+1, переводит чтение на DTO и конфигурирует отложенную загрузку. CX Codex +1 ★ 234звёзд репо

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

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