Communitygithub.com

YepAPI/skills

Gerencie filas de trabalho com BullMQ, Inngest, Trigger.dev, incluindo retentativas de jobs, filas de mensagens mortas e controle de concorrência.

O que é skills?

Este skill fornece um guia completo para implementar e gerenciar jobs em segundo plano em aplicações, utilizando ferramentas modernas como BullMQ (para filas Redis auto-gerenciadas), Inngest e Trigger.dev (para soluções serverless/gerenciadas). Ele ensina como estruturar jobs idempotentes com retentativas automáticas usando backoff exponencial, configurar filas de mensagens mortas (DLQ) para evitar perda silenciosa de jobs, e definir limites de concorrência por fila para evitar sobrecarga dos workers. O skill também sugere práticas como manter os payloads dos jobs pequenos (apenas IDs e referências), separar filas por prioridade (critical, default, low) e monitorar a profundidade das filas e o tempo de processamento para reagir a gargalos. Inclui exemplos de código TypeScript para BullMQ e Inngest, cobrindo desde a configuração de filas e workers até a definição de funções serverless.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Jobs em Segundo Plano

Regras

  • Descarregar trabalho lento para jobs em segundo plano: e-mails, processamento de imagens, webhooks, relatórios, chamadas de IA
  • Usar BullMQ para filas Redis auto-gerenciadas — Inngest ou Trigger.dev para soluções serverless/gerenciadas
  • Todo job deve ser idempotente — seguro para reexecutar sem efeitos colaterais (use chaves de idempotência)
  • Retentar com backoff exponencial: 3-5 tentativas, com atrasos de 1s, 10s, 60s, 5min
  • Fila de mensagens mortas (DLQ): após o máximo de retentativas, mover para DLQ para investigação — nunca descartar silenciosamente
  • Definir limites de concorrência por fila — evitar sobrecarga do worker (ex.: concurrency: 5)
  • Payloads de jobs devem ser pequenos: passar IDs e referências, não objetos completos
  • Separar filas por prioridade: critical (pagamentos), default (e-mails), low (análises)
  • Monitorar profundidade da fila e tempo de processamento — alertar quando a fila acumular

Padrões

// BullMQ pattern
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 serverless pattern
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); }
);

Evitar

  • Processar tarefas lentas em handlers de requisições de API — responder rápido, processar em segundo plano
  • Jobs não idempotentes — execução duplicada causará cobranças duplicadas, e-mails duplicados
  • Concorrência ilimitada — esgotará conexões de banco de dados e memória
  • Armazenar payloads grandes na fila de jobs — passar referências

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.

Habilidades Relacionadas