Communitygithub.com

YepAPI/skills

Warteschlangen-Worker mit BullMQ/Inngest/Trigger.dev, Job-Wiederholungen, Dead Letter Queues, Nebenläufigkeit.

Was ist skills?

Dieses Skill für KI-Agenten definiert bewährte Vorgehensweisen und Muster für die Implementierung von Hintergrundjobs mit modernen Queue-Systemen. Es unterstützt sowohl selbstgehostete Redis-Warteschlangen (BullMQ) als auch serverlose/managed Dienste (Inngest, Trigger.dev) und eignet sich daher für verschiedene Bereitstellungsmodelle. Der Fokus liegt auf Idempotenz der Jobs – jeder Job muss sicher wiederholt werden können, ohne unerwünschte Nebenwirkungen zu verursachen, was durch Idempotenzschlüssel gewährleistet wird. Es werden exponentielle Backoff-Strategien (3-5 Versuche mit Verzögerungen von 1s, 10s, 60s, 5min), die Verwendung von Dead Letter Queues (DLQ) zur Untersuchung fehlgeschlagener Jobs und Nebenläufigkeitsbegrenzungen pro Queue beschrieben. Darüber hinaus werden konkrete Codebeispiele für BullMQ und Inngest sowie wichtige Regeln und Anti-Patterns bereitgestellt, darunter die Trennung von Queues nach Priorität (critical, default, low) und die Vermeidung großer Job-Payloads.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/YepAPI/skills/tree/HEAD/skills/background-jobs

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Hintergrundjobs

Regeln

  • Langsame Arbeit in Hintergrundjobs auslagern: E-Mails, Bildverarbeitung, Webhooks, Berichte, KI-Aufrufe
  • BullMQ für selbstgehostete Redis-Warteschlangen – Inngest oder Trigger.dev für serverlos/managed
  • Jeder Job muss idempotent sein – sicher wiederholbar ohne Seiteneffekte (Idempotenzschlüssel verwenden)
  • Wiederholung mit exponentiellem Backoff: 3-5 Versuche, Verzögerungen von 1s, 10s, 60s, 5min
  • Dead Letter Queue (DLQ): nach maximalen Wiederholungen in DLQ verschieben zur Untersuchung – niemals still verwerfen
  • Nebenläufigkeitsgrenzen pro Queue festlegen – Worker-Überlastung vermeiden (z.B. concurrency: 5)
  • Job-Payloads sollten klein sein: IDs und Referenzen übergeben, keine vollständigen Objekte
  • Queues nach Priorität trennen: critical (Zahlungen), default (E-Mails), low (Analysen)
  • Queue-Tiefe und Verarbeitungszeit überwachen – warnen, wenn Queue sich staut

Muster

// BullMQ-Muster
import { Queue, Worker } from "bullmq";
const queue = new Queue("emails", { connection: redis });

await queue.add("welcome", { userId }, {
  attempts: 3,
  backoff: { type: "exponential", delay: 1000 },
});

const worker = new Worker("emails", async (job) => {
  await sendWelcomeEmail(job.data.userId);
}, { connection: redis, concurrency: 5 });
// Inngest serverloses Muster
import { inngest } from "./client";

export const sendEmail = inngest.createFunction(
  { id: "send-welcome-email", retries: 3 },
  { event: "user/created" },
  async ({ event }) => { await sendWelcomeEmail(event.data.userId); }
);

Vermeiden

  • Langsame Aufgaben in API-Request-Handlern verarbeiten – schnell antworten, im Hintergrund verarbeiten
  • Nicht-idempotente Jobs – doppelte Ausführung führt zu doppelten Kosten, doppelten E-Mails
  • Unbegrenzte Nebenläufigkeit – erschöpft Datenbankverbindungen und Arbeitsspeicher
  • Große Payloads in der Job-Warteschlange speichern – stattdessen Referenzen übergeben

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

YepAPI/skills

WCAG 2.1 AA — semantic HTML, keyboard navigation, screen readers.

YepAPI/skills

Experiment setup, variant splitting, statistical significance, and feature flag integration.

YepAPI/skills

CRUD generators, data tables, user management, role-based access, and bulk operations.

YepAPI/skills

Monitor what ChatGPT and Gemini say about your brand using YepAPI.

YepAPI/skills

Commander.js, interactive prompts with Clack, spinners, colors, config files, exit codes, and npm publishing.

YepAPI/skills

cmdk integration, Cmd+K trigger, fuzzy search, grouped actions, keyboard navigation, and dynamic action registration.

YepAPI/skills

Content planning with trend and sentiment data from YepAPI.

YepAPI/skills

Content calendar, keyword-driven planning, and content briefs.

YepAPI/skills

Theme switching with CSS variables, system preference detection, next-themes, and persistence.

YepAPI/skills

Threaded comments, @mentions, reactions, moderation queue, optimistic UI, and cursor pagination.

YepAPI/skills

Competitive analysis between domains using YepAPI.

YepAPI/skills

Layout grids, KPI cards, data tables with sorting/filtering, sidebar navigation, and responsive breakpoints.

YepAPI/skills

Data encryption — TLS everywhere, AES-256-GCM for PII, bcrypt passwords, encrypted backups.

YepAPI/skills

Chart patterns with Recharts/Nivo/D3, responsive containers, color scales, and accessibility.

YepAPI/skills

Drizzle schema definition, push vs migrate, type-safe queries, relations, transactions, and prepared statements.

YepAPI/skills

Upload handling, resize/compress, CDN delivery, blur placeholders, and next/image patterns.

YepAPI/skills

Local business and Google Maps research using YepAPI.

YepAPI/skills

Cursor-based pagination, IntersectionObserver, virtualized lists with @tanstack/react-virtual, and scroll position restoration.

YepAPI/skills

Tenant isolation (row-level vs schema), subdomain routing, per-tenant config, and data partitioning.

YepAPI/skills

Chat UI components, streaming responses with AI SDK, context window management, and RAG patterns.

Verwandte Skills