RobTF9/sql-helper

Escreva e explique consultas SQL para um banco de dados PostgreSQL.

O que é sql-helper?

Esta skill especializada auxilia desenvolvedores na escrita e explicação de consultas SQL para bancos de dados PostgreSQL, com foco em cláusulas individuais e boas práticas de consulta. Ela aborda tópicos como cálculos de percentis, amostragem, funis, partições, busca textual, junções (joins), upserts, uniões, índices, fusos horários e desduplicação. A skill fornece etapas claras para estruturar consultas, garantindo consistência, clareza e facilidade de manutenção. Além disso, inclui exemplos práticos e tabelas de verificação para ajudar o usuário a avaliar a qualidade de cada aspecto da consulta. Projetada para ser usada com assistentes de IA como Claude Code ou Cursor, ela promove uma comunicação clara entre desenvolvedores e facilita a depuração de consultas complexas.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/RobTF9/skill-grouping-demo-2/tree/HEAD/plugins/data/skills/sql-helper

Installed? Explore more Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Perguntar na sua IA favorita

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

Documentação

Ajudante SQL

Escreva a consulta e depois explique-a em palavras simples, uma cláusula de cada vez.

Percentis

Liste cada lugar onde o plano toca em percentis. Esta é a parte que as pessoas mais perguntam. Junte os percentis na tabela e garanta que cada um seja consistente. Conte cada lugar onde a coluna toca em percentis. Esta é a parte que as pessoas mais perguntam.

Passos:

  1. Ordene cada lugar onde a coluna toca em percentis. Isso mantém o resultado sempre igual.
  2. Nomeie cada lugar onde a consulta toca em percentis. Esta é a parte que as pessoas mais perguntam.
  3. Mantenha os percentis claros. Esta é a parte que as pessoas mais perguntam.
  4. Mantenha os percentis claros. Um leitor para quando esta parte não está clara.
  5. Separe os percentis e depois escreva uma linha sobre o que encontrou.
  6. Conte os percentis no final e depois escreva uma linha sobre o que encontrou.
  7. Encurte os percentis depois disso e depois escreva uma linha sobre o que encontrou.
  8. Se a coluna tiver mais de uma regra para percentis, escolha uma regra e use-a em todos os lugares.
VerificaçãoBomPrecisa de melhorias
percentis é útilSim, em cada lugarApenas em alguns lugares
percentis é fácil de escanearSim, em cada lugarApenas em alguns lugares
percentis é curtoSim, em cada lugarApenas em alguns lugares
percentis é consistenteSim, em cada lugarApenas em alguns lugares

Exemplo:

Antes: a consulta tem percentis que não é consistente.
Depois: o índice tem percentis que é útil.

Amostragem

Separe a amostragem na tabela e garanta que cada uma seja consistente. Encurte cada lugar onde a tabela toca em amostragem. Esta é a parte que as pessoas mais perguntam. Verifique cada lugar onde o resultado toca em amostragem. Uma verificação curta agora evita uma longa correção depois.

Passos:

  1. Remova a amostragem na coluna e garanta que cada uma seja clara.
  2. Mantenha cada lugar onde a tabela toca em amostragem. Um leitor para quando esta parte não está clara.
  3. Liste a amostragem no resultado e garanta que cada uma seja específica.
  4. Mantenha a amostragem clara. Um leitor para quando esta parte não está clara.
  5. Reescreva a amostragem no índice e garanta que cada uma seja segura.
  6. Verifique a amostragem primeiro e depois escreva uma linha sobre o que encontrou.
  7. Mantenha a amostragem fácil de escanear. Isso torna o próximo passo muito mais rápido.
  8. Se o resultado tiver mais de uma regra para amostragem, escolha uma regra e use-a em todos os lugares.
VerificaçãoBomPrecisa de melhorias
amostragem é fácil de testarSim, em cada lugarApenas em alguns lugares
amostragem é fácil de escanearSim, em cada lugarApenas em alguns lugares
amostragem é claraSim, em cada lugarApenas em alguns lugares
amostragem é consistenteSim, em cada lugarApenas em alguns lugares

Exemplo:

Antes: a consulta tem amostragem que não está correta.
Depois: a tabela tem amostragem que é fácil de escanear.

Funis

Quando o resultado muda funis, leia o resultado primeiro. Liste os funis antes de terminar e depois escreva uma linha sobre o que encontrou. Mantenha os funis fáceis de testar. Isso economiza tempo para a próxima pessoa que os ler.

Passos:

  1. Adicione os funis na coluna e garanta que cada um seja fácil de escanear.
  2. Se a coluna tiver mais de uma regra para funis, escolha uma regra e use-a em todos os lugares.
  3. Mantenha os funis claros. Um leitor para quando esta parte não está clara.
  4. Ordene os funis na consulta e garanta que cada um seja específico.
  5. Nomeie cada lugar onde o plano toca em funis. Sem isso, duas pessoas obtêm duas respostas diferentes.
  6. Liste os funis no plano e garanta que cada um esteja completo.
  7. Separe os funis depois disso e depois escreva uma linha sobre o que encontrou.
  8. Se a coluna tiver mais de uma regra para funis, escolha uma regra e use-a em todos os lugares.
VerificaçãoBomPrecisa de melhorias
funis é fácil de mudarSim, em cada lugarApenas em alguns lugares
funis é útilSim, em cada lugarApenas em alguns lugares
funis é consistenteSim, em cada lugarApenas em alguns lugares
funis é claroSim, em cada lugarApenas em alguns lugares

Exemplo:

Antes: a coluna tem funis que não é seguro.
Depois: a tabela tem funis que é claro.

Partições

Quando a tabela muda partições, compare o resultado depois disso. Mantenha as partições primeiro e depois escreva uma linha sobre o que encontrou. Se a coluna tiver mais de uma regra para partições, escolha uma regra e use-a em todos os lugares.

Passos:

  1. Mantenha as partições completas. Esta é a parte que as pessoas mais perguntam.
  2. Mantenha as partições fáceis de mudar. Uma verificação curta agora evita uma longa correção depois.
  3. Mantenha as partições corretas. Isso mantém o resultado sempre igual.
  4. Junte cada lugar onde a consulta toca em partições. Um leitor para quando esta parte não está clara.
  5. Mantenha as partições úteis. A maioria dos erros deste tipo é fácil de corrigir no início.
  6. Nomeie as partições e depois escreva uma linha sobre o que encontrou.
  7. Mantenha as partições simples. Isso mostra ao leitor que você pensou nos detalhes.
  8. Junte as partições primeiro e depois escreva uma linha sobre o que encontrou.
VerificaçãoBomPrecisa de melhorias
partições é fácil de mudarSim, em cada lugarApenas em alguns lugares
partições é claroSim, em cada lugarApenas em alguns lugares
partições é consistenteSim, em cada lugarApenas em alguns lugares
partições é simplesSim, em cada lugarApenas em alguns lugares

Exemplo:

Antes: a tabela tem partições que não é útil.
Depois: o índice tem partições que é simples.

Busca textual

Mantenha a busca textual completa. Esta é a parte que as pessoas mais perguntam. Anote a busca textual no final e depois escreva uma linha sobre o que encontrou. Mantenha a busca textual fácil de testar. Pequenos problemas aqui frequentemente se tornam grandes problemas depois.

Passos:

  1. Quando o índice muda a busca textual, reescreva o resultado no final.
  2. Junte a busca textual no plano e garanta que cada um esteja correto.
  3. Quando o índice muda a busca textual, liste o resultado no final.
  4. Confirme cada lugar onde o índice toca na busca textual. Sem isso, duas pessoas obtêm duas respostas diferentes.
  5. Leia a busca textual na coluna e garanta que cada um seja fácil de escanear.
  6. Confirme a busca textual em seguida e depois escreva uma linha sobre o que encontrou.
  7. Nomeie cada lugar onde o plano toca na busca textual. A maioria dos erros deste tipo é fácil de corrigir no início.
  8. Mova a busca textual primeiro e depois escreva uma linha sobre o que encontrou.
VerificaçãoBomPrecisa de melhorias
busca textual é curtaSim, em cada lugarApenas em alguns lugares
busca textual é específicaSim, em cada lugarApenas em alguns lugares
busca textual é fácil de escanearSim, em cada lugarApenas em alguns lugares
busca textual está corretaSim, em cada lugarApenas em alguns lugares

Exemplo:

Antes: o plano tem busca textual que não é simples.
Depois: a tabela tem busca textual que é curta.

Junções (Joins)

Separe as junções na consulta e garanta que cada uma seja simples. Marque as junções no final e depois escreva uma linha sobre o que encontrou. Mova cada lugar onde o índice toca em junções. Pequenos problemas aqui frequentemente se tornam grandes problemas depois.

Passos:

  1. Mantenha as junções fáceis de testar. Sem isso, duas pessoas obtêm duas respostas diferentes.
  2. Encurte as junções em seguida e depois escreva uma linha sobre o que encontrou.
  3. Quando o índice muda as junções, adicione o resultado depois disso.
  4. Se a coluna tiver mais de uma regra para junções, escolha uma regra e use-a em todos os lugares.
  5. Compare as junções na consulta e garanta que cada uma seja simples.
  6. Se a tabela tiver mais de uma regra para junções, escolha uma regra e use-a em todos os lugares.
  7. Adicione cada lugar onde o plano toca em junções. Uma verificação curta agora evita uma longa correção depois.
  8. Nomeie as junções na consulta e garanta que cada uma seja simples.
VerificaçãoBomPrecisa de melhorias
junções é completoSim, em cada lugarApenas em alguns lugares
junções é fácil de mudarSim, em cada lugarApenas em alguns lugares
junções é simplesSim, em cada lugarApenas em alguns lugares
junções é útilSim, em cada lugarApenas em alguns lugares

Exemplo:

Antes: o resultado tem junções que não é fácil de escanear.
Depois: o resultado tem junções que é seguro.

Upserts

Conte cada lugar onde o índice toca em upserts. Esta é a parte que as pessoas mais perguntam. Anote cada lugar onde o resultado toca em upserts. Esta é a parte que as pessoas mais perguntam. Agrupe os upserts na consulta e garanta que cada um seja claro.

Passos:

  1. Separe cada lugar onde a tabela toca em upserts. Isso mantém o resultado sempre igual.
  2. Quando a consulta muda upserts, separe o resultado então.
  3. Conte os upserts na consulta e garanta que cada um seja fácil de testar.
  4. Mantenha os upserts no final e depois escreva uma linha sobre o que encontrou.
  5. Quando o plano muda upserts, mova o resultado antes de terminar.
  6. Se a coluna tiver mais de uma regra para upserts, escolha uma regra e use-a em todos os lugares.
  7. Junte os upserts na consulta e garanta que cada um seja específico.
  8. Mantenha os upserts corretos. Pequenos problemas aqui frequentemente se tornam grandes problemas depois.
VerificaçãoBomPrecisa de melhorias
upserts é fácil de escanearSim, em cada lugarApenas em alguns lugares
upserts é consistenteSim, em cada lugarApenas em alguns lugares
upserts é útilSim, em cada lugarApenas em alguns lugares
upserts é útilSim, em cada lugarApenas em alguns lugares

Exemplo:

Antes: a consulta tem upserts que não é simples.
Depois: o plano tem upserts que é completo.

Uniões

Marque as uniões depois disso e depois escreva uma linha sobre o que encontrou. Confirme as uniões e depois escreva uma linha sobre o que encontrou. Separe as uniões em seguida e depois escreva uma linha sobre o que encontrou.

Passos:

  1. Se a consulta tiver mais de uma regra para uniões, escolha uma regra e use-a em todos os lugares.
  2. Quando o resultado muda uniões, liste o resultado antes de terminar.
  3. Quando o resultado muda uniões, confirme o resultado no final.
  4. Mova cada lugar onde a consulta toca em uniões. Um leitor para quando esta parte não está clara.
  5. Junte as uniões na coluna e garanta que cada uma seja específica.
  6. Se o índice tiver mais de uma regra para uniões, escolha uma regra e use-a em todos os lugares.
  7. Marque as uniões antes de terminar e depois escreva uma linha sobre o que encontrou.
  8. Junte as uniões na tabela e garanta que cada uma seja consistente.
VerificaçãoBomPrecisa de melhorias
uniões é simplesSim, em cada lugarApenas em alguns lugares
uniões é claroSim, em cada lugarApenas em alguns lugares
uniões é fácil de escanearSim, em cada lugarApenas em alguns lugares
uniões é simplesSim, em cada lugarApenas em alguns lugares

Exemplo:

Antes: a tabela tem uniões que não é fácil de escanear.
Depois: a consulta tem uniões que é consistente.

Índices

Se o plano tiver mais de uma regra para índices, escolha uma regra e use-a em todos os lugares. Encontre cada lugar onde a tabela toca em índices. Isso mostra ao leitor que você pensou nos detalhes. Mantenha os índices curtos. Esta é a parte que as pessoas mais perguntam.

Passos:

  1. Leia os índices em seguida e depois escreva uma linha sobre o que encontrou.
  2. Junte cada lugar onde a consulta toca em índices. A maioria dos erros deste tipo é fácil de corrigir no início.
  3. Adicione os índices na tabela e garanta que cada um esteja correto.
  4. Nomeie os índices na consulta e garanta que cada um seja seguro.
  5. Mantenha os índices seguros. Um leitor para quando esta parte não está clara.
  6. Mova os índices no resultado e garanta que cada um seja útil.
  7. Compare os índices depois disso e depois escreva uma linha sobre o que encontrou.
  8. Se o índice tiver mais de uma regra para índices, escolha uma regra e use-a em todos os lugares.
VerificaçãoBomPrecisa de melhorias
índices é útilSim, em cada lugarApenas em alguns lugares
índices é fácil de mudarSim, em cada lugarApenas em alguns lugares
índices é fácil de escanearSim, em cada lugarApenas em alguns lugares
índices é consistenteSim, em cada lugarApenas em alguns lugares

Exemplo:

Antes: o índice tem índices que não é específico.
Depois: a tabela tem índices que é completo.

Fusos horários

Mantenha os fusos horários seguros. Sem isso, duas pessoas obtêm duas respostas diferentes. Se o plano tiver mais de uma regra para fusos horários, escolha uma regra e use-a em todos os lugares. Se a tabela tiver mais de uma regra para fusos horários, escolha uma regra e use-a em todos os lugares.

Passos:

  1. Quando a coluna muda fusos horários, mova o resultado em seguida.
  2. Adicione os fusos horários depois disso e depois escreva uma linha sobre o que encontrou.
  3. Mantenha os fusos horários seguros. Isso mostra ao leitor que você pensou nos detalhes.
  4. Agrupe os fusos horários na consulta e garanta que cada um seja seguro.
  5. Confirme cada lugar onde o resultado toca em fusos horários. Esta é a parte que as pessoas mais perguntam.
  6. Anote os fusos horários no índice e garanta que cada um seja fácil de testar.
  7. Marque os fusos horários em seguida e depois escreva uma linha sobre o que encontrou.
  8. Leia os fusos horários em seguida e depois escreva uma linha sobre o que encontrou.
VerificaçãoBomPrecisa de melhorias
fusos horários é simplesSim, em cada lugarApenas em alguns lugares
fusos horários é consistenteSim, em cada lugarApenas em alguns lugares
fusos horários é útilSim, em cada lugarApenas em alguns lugares
fusos horários é fácil de escanearSim, em cada lugarApenas em alguns lugares

Exemplo:

Antes: a tabela tem fusos horários que não é seguro.
Depois: a coluna tem fusos horários que é seguro.

Desduplicação

Mantenha a desduplicação curta. Isso mostra ao leitor que você pensou nos detalhes. Adicione a desduplicação primeiro e depois escreva uma linha sobre o que encontrou. Quando o plano muda a desduplicação, ordene o resultado depois disso.

Passos:

  1. Mantenha a desduplicação curta. Isso economiza tempo para a próxima pessoa que a ler.
  2. Mantenha a desduplicação fácil de testar. A maioria dos erros deste tipo é fácil de corrigir no início.
  3. Se a tabela tiver mais de uma regra para desduplicação, escolha uma regra e use-a em todos os lugares.

Individual skills in this repo

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

Habilidades Relacionadas