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

messenger-retry-failures — скилл ретраев для Symfony Messenger

Скилл messenger-retry-failures разбирает сбои обработчиков Symfony Messenger: когда сообщение стоит повторить, когда сразу отправить в failure transport и как потом достать его оттуда.

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

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

Что делает messenger-retry-failures

Скилл ведёт по сбоям Symfony Messenger и первым делом просит разнести каждую ошибку по классу исключения — UnrecoverableMessageHandlingException, если повторять бессмысленно, RecoverableMessageHandlingException, если причина временная.

Дальше настраивается retry_strategy для транспорта (max_retries, delay, multiplier, max_delay) и отдельный failure_transport под окончательно упавшие сообщения. Свой RetryStrategyInterface пишут только когда встроенного backoff не хватает, и регистрируют через retry_strategy.service. Обработчик при этом должен быть идемпотентным, с устойчивым ключом для внешних вызовов.

Разбор идёт через messenger:failed:show, затем messenger:failed:retry или messenger:failed:remove. Учтите: forceRetry: true и retryDelay на исключении помечены как 8.1+, а forceRetry проходит мимо max_retries — без проверки версии рассчитывать на них нельзя. Без --force команда повтора спрашивает подтверждение, поэтому сообщение сначала читают с -vv. Для алертов скилл подписывает на WorkerMessageFailedEvent и реагирует только когда willRetry() вернул false.

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

  • разнести ошибки обработчика по recoverable и unrecoverable
  • настроить backoff для транспорта, чтобы упавший сервис не долбили повторами
  • вынести окончательно упавшие сообщения в отдельную очередь
  • посмотреть, повторить или удалить конкретное сообщение из failure transport
  • поднять алерт только на окончательный провал, без шума от промежуточных попыток

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

  • Разбери, почему падает обработчик SendInvoiceHandler, и подбери исключение для каждого случая.
  • Настрой retry_strategy для транспорта async и заведи отдельный failure_transport.
  • Покажи упавшие сообщения через messenger:failed:show и удали те, что с битым payload.

Как установить messenger-retry-failures

1Через Skills CLI (Vercel)

npx skills add dev-toolings/superpowers-symfony --skill messenger-retry-failures -a claude-code

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

~/.claude/skills/messenger-retry-failures/SKILL.md

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

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

Вопросы о messenger-retry-failures

Как установить messenger-retry-failures в Claude Code?

Выполните npx skills add dev-toolings/superpowers-symfony --skill messenger-retry-failures -a claude-code. Файл скилла появится в ~/.claude/skills/messenger-retry-failures/SKILL.md.

Что делает messenger-retry-failures?

Помогает решить, повторять обработку сообщения или сдаваться, настраивает ретраи и failure transport, а потом разбирает упавшие сообщения командами messenger:failed:*.

Зачем нужны Recoverable и Unrecoverable исключения?

UnrecoverableMessageHandlingException говорит Messenger, что повтор не поможет, например при неверном вводе. RecoverableMessageHandlingException ставят, когда причина сбоя временная и следующий заход может пройти.

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

SKILL.md · MIT
---
name: messenger-retry-failures
description: Handle message failures with retry strategies, failure transport, and recovery in Symfony Messenger (Recoverable/Unrecoverable exceptions)
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
---

# Messenger Retry Failures (Symfony)

## Use when
- A handler fails and you must decide between retrying and giving up.
- Tuning `retry_strategy` (`max_retries`, `delay`, `multiplier`, `max_delay`) for a transport.
- Inspecting, retrying, or removing messages in the failure transport.
- Alerting when a message fails for good.

## Default workflow
1. Classify each failure: `UnrecoverableMessageHandlingException` when retrying cannot help, `RecoverableMessageHandlingException` when the cause is transient.
2. Set `retry_strategy` per transport and point `failure_transport` to a dedicated queue.
3. Implement `RetryStrategyInterface` only when the built-in backoff is not enough, and register it through `retry_strategy.service`.
4. Make the handler idempotent, with a stable idempotency key for external calls.
5. Triage with `messenger:failed:show`, then `messenger:failed:retry` or `messenger:failed:remove`.
6. Subscribe to `WorkerMessageFailedEvent` and alert only when `willRetry()` is false.

## Guardrails
- Never retry what cannot succeed, such as invalid input or a declined card.
- Keep `max_retries` modest (3-5 usually) with exponential backoff, so a failing service is not hammered.
- `retryDelay` and `forceRetry` on the recoverable exception are marked 8.1+ in the reference, and `forceRetry: true` goes past `max_retries`: verify the version before relying on them.
- `messenger:failed:retry` is interactive unless `--force`: read the message with `-vv` first.

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

## Output contract
- The exception class chosen for each failure mode of the handler.
- Retry settings per transport, and the failure transport.
- The failed-message runbook (show, retry, remove) and the alert on final failure.

## 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звёзд репо api-idempotency-retry Samuel Berthe Скилл api-idempotency-retry помогает спроектировать Idempotency-Key и правила повторов для публичного API, чтобы интеграторы ретраили POST без дублей. CX Codex +1 10 400установок hookdeck-event-gateway hookdeck Подключает Hookdeck Event Gateway — инфраструктуру приёма вебхуков с очередью, повторами и мониторингом. CX Codex +1 214установок 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установок appwrite-php appwrite Скилл appwrite-php подсказывает агенту, как писать серверный PHP под Appwrite: пользователи, таблицы, файлы, функции. Пригодится в Laravel и Symfony. CX Codex +1 898установок

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

Весь набор →
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звёзд репо api-platform-resources Скилл api-platform-resources для Claude Code настраивает ресурсы API Platform для REST и GraphQL. Подключается при создании ресурса или настройке операций, пагинации и OpenAPI. CX Codex +1 ★ 234звёзд репо api-platform-state-providers Скилл api-platform-state-providers помогает настроить кастомные State Provider и Processor в API Platform и Symfony. Отвязывает выборку и сохранение данных от сущностей Doctrine. CX Codex +1 ★ 234звёзд репо api-platform-dto-resources Скилл api-platform-dto-resources для Claude Code отделяет API-контракт от Doctrine-сущности в API Platform через Object Mapper. Маппинг учитывает различия полей и отдельные формы для create, update и list. CX Codex +1 ★ 234звёзд репо api-platform-filters Скилл api-platform-filters ведёт агента по фильтрам API Platform в Symfony: query-параметры, классы фильтров под установленную версию и свои фильтры для нестандартных запросов. CX Codex +1 ★ 234звёзд репо doctrine-performance-optimizer Субагент doctrine-performance-optimizer проводит аудит кода Doctrine ORM в режиме чтения: находит лишние запросы в цикле, проверяет стратегии загрузки связей и предлагает DTO-гидратацию или составные индексы. CX Codex ★ 234звёзд репо

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

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