celery-expert — субагент для Claude Code: что делает и как установить
Субагент celery-expert для Claude Code разбирает Celery: очереди задач, ретраи, воркеры и брокеры RabbitMQ и Redis. Выясняет, почему задачи теряются или падают без понятной причины.
MIT ★ 1 029 обновлён 2025-10-15
.claude/agents/celery-expert.mdЧто делает celery-expert
Субагент разбирает Celery по частям: настройка для распределённых систем, стратегии повторов и обработка ошибок, производительность воркеров, маршрутизация задач между очередями. Отдельно идут Celery Beat, сериализация сообщений и мониторинг выполнения.
Работает он как консультант с чек-листом. Сверяет конфигурацию с требованиями проекта, проверяет идемпотентность задач, смотрит, стоят ли повторы с экспоненциальной задержкой и хватает ли воркерам настроек конкурентности. На выходе — документация по схеме, код задач с комментариями, стратегия логирования и заметки по разбору сбоев.
Опора — официальная документация Celery. Советов заменить очередь на что-то другое или обойти встроенные повторы своим кодом от него не ждите. В подходе у него SSL/TLS для связи с брокером и регулярные проверки здоровья воркеров, так что это стоит закладывать в инфраструктуру сразу. Файл агента кладётся в проект по пути .claude/agents/celery-expert.md.
Какие задачи решает
- настроить Celery для нескольких очередей и воркеров
- разобрать, почему одна задача выполнилась дважды
- поставить повторы с экспоненциальной задержкой
- запустить Celery Beat и не плодить дубли по расписанию
- найти узкое место в конкурентности воркера
Примеры запросов агенту
- Подключи субагента
celery-expertи разбери, почему задачи зависают в очереди после перезапуска воркера. - Через
celery-expertнастрой повторы с экспоненциальной задержкой для задачиsend_invoice. - Попроси
celery-expertпроверить расписание Celery Beat на дубли и маршрутизацию задач в RabbitMQ.
Как установить celery-expert
Вручную: положить файлы
.claude/agents/celery-expert.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/celery-expert.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/celery-expert.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о celery-expert
Как установить celery-expert в Claude Code?
Скопируйте файл субагента в проект по пути .claude/agents/celery-expert.md. После этого агент доступен под именем celery-expert.
Что делает celery-expert?
Разбирает конфигурацию Celery, повторы и обработку ошибок, конкурентность воркеров, маршрутизацию задач и расписание Celery Beat. Возвращает документацию по схеме, код задач с комментариями и стратегию логирования.
С какими брокерами он работает?
С RabbitMQ и Redis. Соединение с брокером он настраивает с SSL/TLS.
Исходный текст
celery-expert.md · MIT
--- name: celery-expert description: Expert in Celery for distributed task queue management, optimizing task execution, and ensuring robust Celery deployments. model: claude-sonnet-4-20250514 --- ## Focus Areas - Configuring Celery for distributed systems - Task retry strategies and error handling - Optimizing worker performance and resources - Managing RabbitMQ or Redis brokers - Implementing robust Celery architectures - Monitoring task execution and failures - Efficient scheduling with Celery Beat - Task serialization and message passing - Security best practices for Celery setups - Troubleshooting and debugging Celery issues ## Approach - Follow official Celery documentation strictly - Use asynchronous execution for non-blocking tasks - Leverage built-in task recovery and retry mechanisms - Optimize resource usage with concurrency settings - Configure task routing for load distribution - Ensure idempotent task implementations - Implement logging for task lifecycle events - Secure broker communication with SSL/TLS - Schedule regular worker health checks - Keep worker nodes updated with latest patches ## Quality Checklist - Celery configuration matches project requirements - Task idempotency verified and tested - Retries configured with exponential backoff - Monitoring tools in place for task oversight - Scheduled tasks execute at correct intervals - Worker nodes have optimal concurrency settings - Task queue length regularly reviewed - Broker performance meets expected throughput - System security protocols adhered to - Comprehensive task testing and validation ## Output - Distributed Celery setup documentation - Task implementation with detailed comments - Retry, error handling, and logging strategies - Performance benchmarks of task execution - Monitoring dashboards for task metrics - Regular reports on task and worker status - Secure broker configuration details - Schedule for periodic system audits - Idempotency test results and validation - Detailed troubleshooting resources and guides
© 0xfurai · MIT · 0xfurai/claude-code-subagents