Communitygithub.com

Futurists2023/tiktok

Práticas recomendadas para Postgres, mantidas pela Supabase, para Postgres rodando em qualquer lugar. Carregue esta skill ANTES de escrever ou alterar qualquer coisa que viva em um banco de dados Postgres: criação ou alteração de tabelas e colunas (incluindo escolha de tipos), design de esquemas, migrações e arquivos de esquema declarativos, políticas RLS e os testes que as verificam, índices, triggers, funções de banco de dados, filas e tarefas agendadas (pg_cron, pgmq), busca vetorial/semântica (pgvector) e restauração de dumps (pg_restore) ou importação de dados. Carregue-a também ao diagnosticar consultas lentas, alta CPU, timeouts, planos EXPLAIN, esgotamento de conexões, bloqueios, inchaço ou linhas visíveis para o usuário ou locatário errado. Este não é apenas um guia de performance — tarefas de esquema, migração, segurança e criação de SQL também precisam dessas regras, mesmo para uma alteração de uma coluna ou uma única consulta.

O que é tiktok?

Esta skill fornece um conjunto abrangente de práticas recomendadas para otimização de banco de dados Postgres, mantido pela Supabase. Ela organiza regras em 8 categorias priorizadas por impacto, cobrindo desde performance de consultas e gerenciamento de conexões até design de esquemas e segurança com RLS. A skill é indicada para desenvolvedores e agentes de IA que trabalham com Postgres em qualquer ambiente (Supabase ou não) e deve ser carregada antes de criar ou modificar tabelas, migrações, índices, triggers, filas ou consultas. Inclui referências a arquivos de regras individuais com exemplos SQL corretos e incorretos, além de links para documentação oficial do Postgres e da Supabase. É útil tanto para tarefas rotineiras de schema quanto para diagnósticos de performance, garantindo que melhores práticas sejam seguidas consistentemente.

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

Perguntar na sua IA favorita

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

Documentação

Práticas Recomendadas para Postgres da Supabase

Guia abrangente de otimização de performance para Postgres, mantido pela Supabase. Contém regras em 8 categorias, priorizadas por impacto para orientar a otimização automatizada de consultas e o design de esquemas.

Quando Aplicar

Consulte estas diretrizes quando:

  • Escrevendo consultas SQL ou projetando esquemas
  • Implementando índices ou otimização de consultas
  • Revisando problemas de performance do banco de dados
  • Configurando pool de conexões ou escalabilidade
  • Otimizando para recursos específicos do Postgres
  • Trabalhando com Segurança em Nível de Linha (RLS)

Categorias de Regras por Prioridade

PrioridadeCategoriaImpactoPrefixo
1Performance de ConsultasCRÍTICOquery-
2Gerenciamento de ConexõesCRÍTICOconn-
3Segurança e RLSCRÍTICOsecurity-
4Design de EsquemasALTOschema-
5Concorrência e BloqueiosMÉDIO-ALTOlock-
6Padrões de Acesso a DadosMÉDIOdata-
7Monitoramento e DiagnósticoBAIXO-MÉDIOmonitor-
8Recursos AvançadosBAIXOadvanced-

Como Usar

Leia os arquivos de regras individuais para explicações detalhadas e exemplos SQL:

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

Cada arquivo de regra contém:

  • Breve explicação de por que é importante
  • Exemplo SQL incorreto com explicação
  • Exemplo SQL correto com explicação
  • Saída EXPLAIN ou métricas opcionais
  • Contexto adicional e referências
  • Notas específicas da Supabase (quando aplicável)

Referências

Individual skills in this repo

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

Habilidades Relacionadas