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

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

Скилл async-jobs для Claude Code содержит правила и шаблоны для настройки очередей задач, повторов и воркфлоу в Celery, ARQ, Redis и Temporal.

MIT 195 установок ★ 305 обновлён 2026-11-14

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

Что делает async-jobs

Скилл содержит готовые инженерные решения для фоновой обработки задач: пороги задержек, таймауты, конфигурации воркеров и шаблоны Celery Canvas (цепочки chain, группы group и chord). Вместо пересказа базовой документации он даёт конкретный набор правил: сериализация только через JSON, подтверждение задач через task_acks_late=True и разделение на пять очередей от critical до bulk.

Внутри заложены готовые схемы для безопасных повторов: экспоненциальный backoff с джиттером до 600 секунд, лимит 3–5 попыток для временных сбоев, ключи идемпотентности в Redis с TTL 86400 секунд и распределённые блокировки от повторного запуска. Для периодических задач описаны модели django-celery-beat.

Для работы требуется Claude Code версии 2.1.277 или новее. Важно учесть замечание авторов: передача аргументов через неизменяемые сигнатуры si() внутри аккордов Celery помечена как непроверенная, поэтому её поведение стоит сверять с официальной документацией.

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

  • настроить маршрутизацию задач по пяти очередям приоритета
  • добавить безопасные повторные запуски с Redis-блокировкой
  • собрать пайплайн фоновых задач на Celery Canvas
  • подключить периодические задачи через django-celery-beat

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

  • Настрой Celery worker с поздним подтверждением задач и разбивкой на очереди critical и bulk
  • Добавь задачу обработки платежа с экспоненциальным backoff и проверкой идемпотентности в Redis
  • Собери пайплайн обработки отчётов на базе Celery chord и групп

Как установить async-jobs

1Через Skills CLI (Vercel)

npx skills add yonatangross/orchestkit --skill async-jobs -a claude-code

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

~/.claude/skills/async-jobs/SKILL.md

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

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

Вопросы об async-jobs

Как установить async-jobs в Claude Code?

Выполните команду в терминале: npx skills add yonatangross/orchestkit --skill async-jobs -a claude-code.

Что делает скилл async-jobs?

Он даёт агенту правила и проверенные конфигурации для Celery, ARQ, Temporal и Redis: схемы очередей, политику повторов, таймауты и шаблоны распределённых задач.

Какие системные требования нужны для работы?

Для скилла требуется Claude Code версии 2.1.277 или выше, а в проекте предполагается использование JSON-сериализатора и Redis для блокировок и хранения ключей идемпотентности.

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

SKILL.md · MIT
---
name: async-jobs
license: MIT
compatibility: "Claude Code 2.1.277+."
description: Async job processing patterns for background tasks, Celery workflows, task scheduling, retry strategies, and distributed task execution. Use when implementing background job processing, task queues, or scheduled task systems.
user-invocable: false
metadata:
  owner-agent: "python-performance-engineer"
  category: workflow-automation
  version: "2.0.0"
  author: "OrchestKit"
  complexity: "medium"
  tags: "async, jobs, celery, background-tasks, scheduling, queues"
allowed-tools: "Read Glob Grep WebFetch WebSearch"
---

# Async Jobs

Background task processing with Celery, ARQ, Redis and Temporal. This skill is a wrapper, not a
manual: Celery and ARQ document their own product well, so what lives here is our delta, the
thresholds, working config, ordering constraints and tool-choice rules we picked. Product
mechanics are linked, not restated.

Start with `Read("references/ork-delta.md")`.

## Quick Reference

| Topic | Where our part lives |
|-------|----------------------|
| [Configuration](#configuration) | `references/celery-config.md`, `rules/jobs-task-queue.md` |
| [Task Routing](#task-routing) | `references/ork-delta.md` (queue taxonomy, prefetch tiers, Redis priority) |
| [Canvas Workflows](#canvas-workflows) | `rules/celery-canvas.md` |
| [Retry Strategies](#retry-strategies) | `references/ork-delta.md` (backoff cap, idempotency layers, lock TTLs) |
| [Scheduling](#scheduling) | `rules/jobs-scheduling.md`, `references/ork-delta.md` (beat process model) |
| [Monitoring](#monitoring) | `references/ork-delta.md` (alert thresholds, histogram buckets) |
| [Result Backends](#result-backends) | `rules/jobs-monitoring.md`, `references/ork-delta.md` (return contract) |
| [ARQ Patterns](#arq-patterns) | `rules/jobs-task-queue.md`, `references/ork-delta.md` (budgets, pool ownership) |
| [Temporal Workflows](#temporal-workflows) | `rules/temporal-workflows.md` |
| [Temporal Activities](#temporal-activities) | `rules/temporal-activities.md` |

10 topic areas, 6 rule files in `rules/`, house delta in `references/ork-delta.md`.

## Quick Start

```python
@app.task(bind=True, max_retries=3, default_retry_delay=60)
def process_payment(self, order_id: str):
    try:
        return gateway.charge(order_id)
    except TransientError as exc:
        raise self.retry(exc=exc, countdown=2 ** self.request.retries * 60)
```

Load more examples: `Read("references/quick-start-examples.md")` for Celery
retry task and ARQ/FastAPI integration patterns.

## Upstream coverage (do not restate)

Fetch these when you need product mechanics. The right-hand column is the part we keep, because
it is a house threshold, a working config or an ordering constraint that upstream cannot know.

| Topic | First-party source | House subset stays in |
|-------|--------------------|-----------------------|
| Celery settings, serializers, time limits, worker flags | https://docs.celeryq.dev/en/stable/userguide/configuration.html and .../optimizing.html | `references/celery-config.md`, `rules/jobs-task-queue.md` |
| Queue declarations, router classes, Redis priority mechanics | https://docs.celeryq.dev/en/stable/userguide/routing.html | `references/ork-delta.md` |
| chain / group / chord / signature semantics | https://docs.celeryq.dev/en/stable/userguide/canvas.html | `rules/celery-canvas.md` keeps the house canvas subset. Its `si()`-in-chords guidance is UNVERIFIED and contested: confirm the argument-passing behaviour against the upstream canvas page before relying on it |
| `autoretry_for`, `retry_backoff`, `Reject`, task base classes | https://docs.celeryq.dev/en/stable/userguide/tasks.html | `references/ork-delta.md`, `rules/jobs-task-queue.md` |
| Beat schedules, crontab syntax, DatabaseScheduler | https://docs.celeryq.dev/en/stable/userguide/periodic-tasks.html and https://django-celery-beat.readthedocs.io/en/latest/ | `rules/jobs-scheduling.md` keeps our `beat_schedule` shapes; `references/ork-delta.md` keeps the process model |
| Flower flags, `inspect`, signal names | https://docs.celeryq.dev/en/stable/userguide/monitoring.html, https://docs.celeryq.dev/en/stable/userguide/signals.html, https://flower.readthedocs.io/en/latest/config.html | `references/ork-delta.md` |
| Result backend, `AsyncResult`, custom states | https://docs.celeryq.dev/en/stable/userguide/configuration.html | `rules/jobs-monitoring.md` keeps our status endpoints and `update_state()` usage |
| Per-task `rate_limit`, `control.rate_limit`, Redis Lua | https://docs.celeryq.dev/en/stable/userguide/workers.html, https://redis.io/docs/latest/develop/programmability/eval-intro/ | `references/ork-delta.md` |
| ARQ `WorkerSettings`, `enqueue_job`, `_defer_by` / `_defer_until`, `Job` status | https://arq-docs.helpmanual.io/ | `rules/jobs-task-queue.md` keeps the worker skeleton; `references/ork-delta.md` keeps the budgets |
| FastAPI lifespan and dependency wiring | https://fastapi.tiangolo.com/advanced/events/ | `references/ork-delta.md` |
| Distributed locks with `SET NX EX` | https://redis.io/docs/latest/commands/set/ | `references/ork-delta.md` |

## Configuration

Load: `Read("references/celery-config.md")`.

| Decision | Recommendation |
|----------|----------------|
| Serializer | JSON (never pickle) |
| Ack mode | Late ack (`task_acks_late=True`) |
| Prefetch | 1 for fair, 4-8 for throughput |
| Time limit | soft < hard (540 / 600) |
| Timezone | UTC always |

## Task Routing

| Decision | Recommendation |
|----------|----------------|
| Queue count | 5: critical / high / default / low / bulk |
| Priority levels | 0-9, with all four Redis priority switches set together |
| Worker assignment | Dedicated worker per queue |
| Prefetch | 1 critical, 2 high, 4 default, 8 low/bulk |
| Routing | Router class once past 5 routing rules |

## Canvas Workflows

Load: `Read("rules/celery-canvas.md")`.

| Decision | Recommendation |
|----------|----------------|
| Sequential | Chain with `s()` |
| Parallel | Group for independent tasks |
| Fan-in | Chord (all header tasks must succeed for the body to run) |
| Ignore input | Use `si()` immutable signature |
| Error in chain | `Reject` stops the chain, `retry` continues it |
| Partial failures | Return an error dict from chord header tasks |

## Retry Strategies

| Decision | Recommendation |
|----------|----------------|
| Retry delay | Exponential backoff, jitter on, capped at 600s |
| Max retries | 3-5 for transient, 0 for permanent |
| Idempotency | Redis marker (86400s TTL) plus the vendor idempotency key |
| Failed tasks | DLQ for manual review |
| Singleton | Redis lock with a TTL longer than the hard time limit |

## Scheduling

Load: `Read("rules/jobs-scheduling.md")`.

| Decision | Recommendation |
|----------|----------------|
| Schedule type | Crontab for time-based, float interval for frequency |
| Dynamic | DatabaseScheduler (`django-celery-beat`) |
| Overlap | Redis lock, 3600s default and 7200s for long jobs |
| Beat process | Separate process; embedded `--beat` is development only |
| Timezone | UTC always |

## Monitoring

| Decision | Recommendation |
|----------|----------------|
| Dashboard | Flower with persistent storage |
| Metrics | Prometheus wired to `task_prerun` / `task_postrun` / `task_failure` |
| Health | Broker reachable, at least one worker, queue depths |
| Alerting | critical > 100, default > 5000, workers < 1 |
| Autoscale | Queue depth > 500 |

## Result Backends

Load: `Read("rules/jobs-monitoring.md")`.

| Decision | Recommendation |
|----------|----------------|
| Status storage | Redis result backend, status and small JSON only |
| Large results | S3 or database, task returns a reference dict |
| Progress | Custom states with `update_state()` |
| Result query | `AsyncResult` with state checks |

## ARQ Patterns

Load: `Read("rules/jobs-task-queue.md")`.

| Decision | Recommendation |
|----------|----------------|
| Simple async | ARQ (native async), `max_jobs=10`, `job_timeout=300` |
| Pool ownership | FastAPI lifespan, never a per-request `create_pool` |
| Complex workflows | Celery (chains, chords, DLQ, per-task rate limits) |
| In-process quick | FastAPI BackgroundTasks, under 30s, non-critical only |
| LLM workflows | LangGraph, not Celery |

## Tool Selection

Load: `Read("references/quick-start-examples.md")` for the full tool
comparison table (ARQ, Celery, RQ, Dramatiq, FastAPI BackgroundTasks).

## Anti-Patterns (FORBIDDEN)

Load details: `Read("references/anti-patterns.md")` for the full list.

Key rules: never run long tasks in request handlers, never block on results inside tasks, never
store large results in Redis, always use idempotency for retried tasks.

## Temporal Workflows

Load: `Read("rules/temporal-workflows.md")`.

| Decision | Recommendation |
|----------|----------------|
| Workflow ID | Business-meaningful, idempotent |
| Determinism | Use `workflow.random()`, `workflow.now()` |
| I/O | Always via activities, never directly |

## Temporal Activities

Load: `Read("rules/temporal-activities.md")`.

| Decision | Recommendation |
|----------|----------------|
| Activity timeout | `start_to_close` for most cases |
| Error handling | Non-retryable for business errors |
| Testing | `WorkflowEnvironment.start_local()` for integration tests |

## Related Skills

- `ork:python-backend` - FastAPI, asyncio, SQLAlchemy patterns
- `ork-extras:langgraph` - LangGraph workflow patterns (use for LLM workflows, not Celery)
- `ork-extras:distributed-systems` - Resilience patterns, circuit breakers
- `ork-extras:monitoring-observability` - Metrics and alerting

## Capability Details

Load details: `Read("references/capability-details.md")` for the keyword index
and problem-to-capability mapping.

© OrchestKit · MIT · yonatangross/orchestkit

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

Все скиллы по теме «Бэкенд и API» →
python-background-jobs Seth Hobson Скилл python-background-jobs для Claude Code выносит долгие Python-задачи из цикла запрос–ответ и обрабатывает их воркерами. Решает задачи очередей, экспортов, уведомлений и событийной архитектуры. CX Codex +1 11 137установок Background Jobs taste f Промпт Background Jobs taste для ChatGPT и Claude.ai задаёт инженерные правила надёжности для фоновых задач и очередей. Помогает проектировать воркеры с защитой от дублей, взаимных блокировок и зависаний. GP ChatGPT ★ 178 201звёзд репо background-jobs-designer patricio0312rev Скилл background-jobs-designer для Claude Code проектирует очереди фоновых задач, повторы и мониторинг. Описывает работу с BullMQ, Celery и асинхронными воркерами. CX Codex +1 286установок django-celery affaan-m Скилл django-celery для Claude Code настраивает фоновые задачи Django и воркеры Celery. Оформляет очереди Redis, планировщик Beat, обработку таймаутов и повторные попытки с бэкоффом. CX Codex +1 6 300установок celery-expert martinholovsky Скилл celery-expert помогает проектировать фоновые задачи и очереди на Celery: ретраи, chains, groups, chords, Celery Beat и мониторинг через Flower. CX Codex +1 460установок django-python Mindrally Скилл django-python для Claude Code, который переключает агента в режим Django-разработчика. Следит за структурой проекта, ORM и типичными ошибками на каждом запросе. CX Codex +1 991установок

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

Весь набор →
audit-full Скилл audit-full проверяет весь код проекта за один проход: ищет проблемы безопасности, архитектуры и зависимостей, сортируя находки по серьёзности. Запускается перед релизом или проверкой безопасности. CX Codex +1 208установок implement Скилл implement собирает новую фичу параллельно: бэкенд, фронтенд, тесты и проверка безопасности в отдельных воркдеревьях. CX Codex +1 206установок demo-producer Скилл demo-producer для Claude Code автоматизирует создание демонстрационных и промо-видео по коду, CLI и плагинам. Запускает связку из VHS и Remotion для подготовки роликов в разных форматах. CX Codex +1 196установок configure Интерактивный мастер для настройки OrchestKit: подключение MCP-серверов, права хуков, горячие клавиши, пресеты. Запускается при первой установке плагина и по команде /orchestkit:configure. CX Codex +1 196установок product-frameworks Скилл product-frameworks для Claude Code даёт фреймворки для финансового анализа, приоритизации, метрик и исследований. С его помощью оформляют бизнес-кейсы, PRD и планы пользовательских исследований. CX Codex +1 194установок golden-dataset Скилл golden-dataset для Claude Code описывает жизненный цикл эталонных датасетов: курацию, девятифазное добавление, регрессионные тесты и интеграцию с Langfuse. CX Codex +1 193установок mcp-patterns Скилл mcp-patterns для Claude Code и Codex помогает проектировать серверы Model Context Protocol. Включается при настройке транспортов, авторизации через OAuth, кэшировании ресурсов и защите от инъекций. CX Codex +1 191установок browser-tools Скилл browser-tools для Claude Code добавляет правила безопасности при автоматизации браузера через agent-browser: этику скрейпинга, паузы, обработку локальных URL и аутентификацию. Включается автоматически при такой работе. CX Codex +1 191установок

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

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