Communitygithub.com

Futurists2023/tiktok

Prácticas recomendadas de Postgres mantenidas por Supabase, para Postgres ejecutándose en cualquier lugar. Carga esta habilidad ANTES de escribir o modificar cualquier cosa que resida en una base de datos Postgres: crear o alterar tablas y columnas (incluyendo la elección de tipos de columna), diseño de esquemas, migraciones y archivos de esquema declarativos, políticas RLS y las pruebas que las verifican, índices, disparadores, funciones de base de datos, colas y trabajos programados (pg_cron, pgmq), búsqueda vectorial/semántica (pgvector) y restauración de volcados (pg_restore) o importación de datos. También cárgalo al diagnosticar consultas lentas, CPU alta, tiempos de espera, planes EXPLAIN, agotamiento de conexiones, bloqueos, hinchazón o filas visibles para el usuario o inquilino incorrecto. Esto no es solo una guía de rendimiento: las tareas de esquema, migración, seguridad y redacción de SQL también necesitan estas reglas, incluso para un cambio de una columna o una sola consulta.

¿Qué es tiktok?

Esta habilidad proporciona un conjunto integral de prácticas recomendadas para Postgres, mantenido por Supabase y aplicable a cualquier instancia de Postgres. Cubre 8 categorías priorizadas por impacto, desde rendimiento de consultas y gestión de conexiones hasta seguridad con RLS, diseño de esquemas, concurrencia, patrones de acceso a datos, monitoreo y características avanzadas. Es útil para desarrolladores y administradores de bases de datos que trabajan con Postgres en cualquier plataforma, especialmente al escribir SQL, diseñar esquemas, implementar migraciones, optimizar consultas lentas o diagnosticar problemas de rendimiento y seguridad. La habilidad se basa en archivos de reglas individuales con ejemplos SQL, explicaciones de por qué importan y notas específicas de Supabase cuando corresponde. Su objetivo es guiar la optimización automática de consultas y el diseño de esquemas, asegurando que todas las interacciones con la base de datos sigan las mejores prácticas, desde cambios triviales hasta operaciones complejas.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Futurists2023/tiktok/tree/HEAD/.agents/skills/supabase-postgres-best-practices

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Prácticas Recomendadas de Postgres de Supabase

Guía completa de optimización de rendimiento para Postgres, mantenida por Supabase. Contiene reglas en 8 categorías, priorizadas por impacto para guiar la optimización automática de consultas y el diseño de esquemas.

Cuándo Aplicar

Consulte estas pautas cuando:

  • Escriba consultas SQL o diseñe esquemas
  • Implemente índices u optimización de consultas
  • Revise problemas de rendimiento de la base de datos
  • Configure agrupación de conexiones o escalado
  • Optimice para características específicas de Postgres
  • Trabaje con Seguridad a Nivel de Fila (RLS)

Categorías de Reglas por Prioridad

PrioridadCategoríaImpactoPrefijo
1Rendimiento de ConsultasCRÍTICOquery-
2Gestión de ConexionesCRÍTICOconn-
3Seguridad y RLSCRÍTICOsecurity-
4Diseño de EsquemasALTOschema-
5Concurrencia y BloqueosMEDIO-ALTOlock-
6Patrones de Acceso a DatosMEDIOdata-
7Monitoreo y DiagnósticoBAJO-MEDIOmonitor-
8Características AvanzadasBAJOadvanced-

Cómo Usar

Lea los archivos de reglas individuales para obtener explicaciones detalladas y ejemplos SQL:

references/query-missing-indexes.md
references/query-partial-indexes.md
references/_sections.md

Cada archivo de regla contiene:

  • Breve explicación de por qué importa
  • Ejemplo SQL incorrecto con explicación
  • Ejemplo SQL correcto con explicación
  • Salida EXPLAIN o métricas opcionales
  • Contexto adicional y referencias
  • Notas específicas de Supabase (cuando corresponda)

Referencias

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills relacionados