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