background-jobs-designer — скилл для Claude Code: фоновые задачи
Скилл background-jobs-designer для Claude Code проектирует очереди фоновых задач, повторы и мониторинг. Описывает работу с BullMQ, Celery и асинхронными воркерами.
MIT 286 установок ★ 64 обновлён 2026-01-12
npx skills add patricio0312rev/skills --skill background-jobs-designer -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/background-jobs-designer/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/background-jobs-designer/
1Через Skills CLI (Vercel)
npx skills add patricio0312rev/skills --skill background-jobs-designer -a codex2Вручную: положить файлы
.agents/skills/background-jobs-designer/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add patricio0312rev/skills --skill background-jobs-designer -a cursor2Вручную: положить файлы
.cursor/skills/background-jobs-designer/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install patricio0312rev/skills backend/background-jobs-designer/SKILL.md2Вручную: положить файлы
.github/skills/background-jobs-designer/SKILL.md1Через Skills CLI (Vercel)
npx skills add patricio0312rev/skills --skill background-jobs-designer -a gemini-cli2Командой платформы
gemini skills install https://github.com/patricio0312rev/skills --path backend/background-jobs-designerВручную: положить файлы
.devin/skills/background-jobs-designer/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add patricio0312rev/skills --skill background-jobs-designer -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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