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

background-jobs-designer — скилл для Claude Code: фоновые задачи

Скилл background-jobs-designer для Claude Code проектирует очереди фоновых задач, повторы и мониторинг. Описывает работу с BullMQ, Celery и асинхронными воркерами.

MIT 286 установок ★ 64 обновлён 2026-01-12

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

Что делает background-jobs-designer

background-jobs-designer помогает собрать архитектуру фоновых задач с очередью, описанием типов работ, политикой повторов и обработкой ошибок. В примерах показаны интеграции BullMQ для Node.js и Celery для Python, включая подключение к Redis и настройку повторной попытки с экспоненциальной задержкой.

Скилл предлагает хранить состояние задачи, отслеживать уже обработанные job.id и выполнять работу внутри транзакции. Отдельные обработчики событий completed, failed и stalled передают данные в метрики и логи. В чек-лист также входят dead letter queue, тайм-ауты и корректное завершение воркера.

Если обработчики failed и stalled не подключены, соответствующие события не попадут в метрики из примера.

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

  • спроектировать очередь для фоновых задач
  • описать типы заданий и их полезную нагрузку
  • настроить повторы с экспоненциальной задержкой
  • защитить воркер от повторной обработки задания
  • добавить метрики завершённых и зависших задач

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

  • Спроектируй фоновые задачи для отправки писем через BullMQ: опиши очередь, воркер, повторы и обработку ошибок.
  • Сделай идемпотентную обработку заданий для process-payment с проверкой job.id и транзакцией базы данных.
  • Добавь мониторинг событий completed, failed и stalled для воркера и подготовь чек-лист запуска.

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

1Через Skills CLI (Vercel)

npx skills add patricio0312rev/skills --skill background-jobs-designer -a claude-code

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

~/.claude/skills/background-jobs-designer/SKILL.md

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

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

Вопросы о background-jobs-designer

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

Выполните npx skills add patricio0312rev/skills --skill background-jobs-designer -a claude-code, затем проверьте файл ~/.claude/skills/background-jobs-designer/SKILL.md.

Что делает background-jobs-designer?

Скилл проектирует фоновые задачи с очередями BullMQ или Celery, политиками повторов, идемпотентностью, обработкой ошибок и мониторингом.

Какие очереди и технологии рассматривает скилл?

В материалах есть примеры BullMQ для Node.js и Celery для Python. Для подключения очереди используются Redis или RabbitMQ; в примере BullMQ задан Redis на localhost и порту 6379.

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

SKILL.md · MIT
---
name: background-jobs-designer
description: Designs background job processing systems with queue integration (BullMQ/Celery), job definitions, retry policies, exponential backoff, idempotent execution, and monitoring hooks. Use when implementing "background jobs", "task queues", "async processing", or "job workers".
---

# Background Jobs Designer

Design reliable background job processing with retries and monitoring.

## Queue Integration

**BullMQ (Node.js)**:

```typescript
import { Queue, Worker } from "bullmq";

const emailQueue = new Queue("email", {
  connection: { host: "localhost", port: 6379 },
});

// Add job
await emailQueue.add(
  "send-welcome",
  {
    userId: "123",
    email: "[email protected]",
  },
  {
    attempts: 3,
    backoff: { type: "exponential", delay: 2000 },
  }
);
```

**Celery (Python)**:

```python
from celery import Celery

app = Celery('tasks', broker='redis://localhost:6379')

@app.task(bind=True, max_retries=3)
def send_email(self, user_id, email):
    try:
        # Send email
        pass
    except Exception as exc:
        raise self.retry(exc=exc, countdown=60)
```

## Job Definitions

```typescript
export interface Job {
  id: string;
  type: string;
  payload: unknown;
  attempts: number;
  maxAttempts: number;
  createdAt: Date;
  processedAt?: Date;
  failedAt?: Date;
  error?: string;
}

export const JOB_TYPES = {
  SEND_EMAIL: "send-email",
  PROCESS_PAYMENT: "process-payment",
  GENERATE_REPORT: "generate-report",
  SYNC_DATA: "sync-data",
} as const;
```

## Retry Strategy

```typescript
// Exponential backoff
const RETRY_CONFIG = {
  maxAttempts: 5,
  delays: [
    1000, // 1 second
    5000, // 5 seconds
    30000, // 30 seconds
    300000, // 5 minutes
    1800000, // 30 minutes
  ],
};

// Worker with retry
const worker = new Worker("email", async (job) => {
  try {
    await sendEmail(job.data);
  } catch (error) {
    if (job.attemptsMade < RETRY_CONFIG.maxAttempts) {
      throw error; // Will retry
    }
    await handleFailedJob(job, error);
  }
});
```

## Idempotent Jobs

```typescript
// Track processed jobs
export const processJob = async (job: Job) => {
  // Check if already processed
  const processed = await db.query(
    "SELECT 1 FROM processed_jobs WHERE job_id = $1",
    [job.id]
  );

  if (processed.rows.length > 0) {
    console.log("Job already processed");
    return; // Idempotent
  }

  await db.transaction(async (trx) => {
    // Mark as processed
    await trx("processed_jobs").insert({ job_id: job.id });

    // Do work
    await performWork(job, trx);
  });
};
```

## Monitoring

```typescript
// Job events
worker.on("completed", (job) => {
  metrics.increment("jobs.completed", { type: job.name });
});

worker.on("failed", (job, err) => {
  metrics.increment("jobs.failed", { type: job.name });
  logger.error("Job failed", { jobId: job.id, error: err });
});

worker.on("stalled", (jobId) => {
  metrics.increment("jobs.stalled");
  logger.warn("Job stalled", { jobId });
});
```

## Best Practices

- Jobs should be idempotent
- Use exponential backoff for retries
- Set reasonable timeouts
- Monitor queue depth
- Dead letter queue for failed jobs
- Log job start/completion
- Graceful shutdown handling

## Output Checklist

- [ ] Queue setup (Redis/RabbitMQ)
- [ ] Job type definitions
- [ ] Retry policy with backoff
- [ ] Idempotency tracking
- [ ] Error handling
- [ ] Monitoring/metrics
- [ ] Dead letter queue
- [ ] Graceful shutdown

© patricio0312rev · MIT · patricio0312rev/skills

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

Все скиллы по теме «Бэкенд и API» →
background-job-orchestrator curiositech Скилл background-job-orchestrator помогает настроить фоновые очереди на BullMQ или Celery. Переносит тяжёлые операции из обработчиков API, добавляет повторные попытки и защищает сервис от перегрузок. CX Codex +1 198установок 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-job-processing aj-geddes Скилл background-job-processing для Claude Code и Codex настраивает фоновую обработку задач: очереди, воркеры, расписание и повторные попытки при сбоях. Письма, отчёты и большие выгрузки уходят из основного потока. CX Codex +1 490установок render-background-workers Render Скилл render-background-workers помогает настроить фоновые воркеры на Render: подключить очередь, поймать SIGTERM и не потерять задачи при деплое. CX Codex +1 432установок async-jobs OrchestKit Скилл async-jobs для Claude Code содержит правила и шаблоны для настройки очередей задач, повторов и воркфлоу в Celery, ARQ, Redis и Temporal. CX Codex +1 195установок

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

Весь набор →
github-actions-pipeline-creator Скилл github-actions-pipeline-creator для Claude Code собирает GitHub Actions workflow для линтинга, тестов, сборки и деплоя. Описывает CI с кэшем, матрицей и артефактами. CX Codex +1 288установок webhook-receiver-hardener Скилл webhook-receiver-hardener помогает проектировать защищённые эндпоинты для вебхуков. Защищает обработчики от подделки запросов, повторных доставок и сбоев сторонних сервисов. CX Codex +1 287установок secrets-scanner Скилл secrets-scanner для Claude Code ищет утёкшие ключи, токены и пароли в коде. Ставит проверки до коммита и в CI. CX Codex +1 287установок project-scaffolder Скилл project-scaffolder разворачивает стартовые репозитории под популярные фреймворки с настроенным линтингом, тестовым эндпоинтом и документацией по запуску. CX Codex +1 287установок adr-writer Скилл adr-writer для Claude Code оформляет архитектурные решения в ADR: фиксирует контекст, выбранный вариант, альтернативы, компромиссы и последствия. Структурирует командные решения. CX Codex +1 286установок quality-gates-enforcer Скилл quality-gates-enforcer внедряет в CI пороги качества кода: следит за покрытием тестами, типами TypeScript, линтингом, безопасностью и размером сборки. CX Codex +1 284установок system-design-generator Скилл system-design-generator для Claude Code собирает план архитектуры по требованиям: компоненты, потоки данных, API-контракты и масштабирование. Помогает проектировать фичи и продукты. CX Codex +1 284установок pii-redaction-logging-policy-builder Скилл pii-redaction-logging-policy-builder помогает настроить маскирование персональных данных в логах и составить политику логирования под GDPR. Заменяет email, телефоны и номера карт на плейсхолдеры. CX Codex +1 283установок

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

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