RobTF9/sql-helper

Écrire et expliquer des requêtes SQL pour une base de données Postgres.

Qu'est-ce que sql-helper ?

Cette compétence, 'sql-helper', est conçue pour aider les développeurs et les utilisateurs d'agents IA (comme Claude Code, Cursor ou Codex) à écrire, comprendre et analyser des requêtes SQL pour une base de données PostgreSQL. Elle se concentre sur l'explication des requêtes en langage naturel, clause par clause, ce qui la rend particulièrement utile pour la documentation, la révision de code ou l'apprentissage. La compétence couvre des concepts avancés de SQL et d'optimisation de base de données, notamment les centiles, l'échantillonnage, les entonnoirs, les partitions, la recherche textuelle, les jointures, les upserts, les unions, les index, les fuseaux horaires et la déduplication. Elle fournit des étapes concrètes pour chaque concept, des tableaux de contrôle qualité pour évaluer la correction et la clarté, ainsi que des exemples avant-après. Bien que le texte original inclue des répétitions et un style algorithmique, la compétence vise à garantir des requêtes SQL cohérentes, lisibles et performantes. Elle est idéale pour les agents d'ingénierie logicielle qui doivent automatiser la génération ou la révision de requêtes complexes.

Compatible avec~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 Développement et programmation skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Assistant SQL

Écrire la requête, puis l'expliquer en termes simples, clause par clause.

Centiles

Listez chaque endroit où le plan touche aux centiles. C'est la partie que les gens demandent le plus souvent. Joignez les centiles dans la table, et assurez-vous que chacun est cohérent. Comptez chaque endroit où la colonne touche aux centiles. C'est la partie que les gens demandent le plus souvent.

Étapes :

  1. Triez chaque endroit où la colonne touche aux centiles. Cela maintient le résultat identique à chaque fois.
  2. Nommez chaque endroit où la requête touche aux centiles. C'est la partie que les gens demandent le plus souvent.
  3. Gardez les centiles clairs. C'est la partie que les gens demandent le plus souvent.
  4. Gardez les centiles clairs. Un lecteur s'arrête lorsque cette partie n'est pas claire.
  5. Divisez ensuite les centiles, puis écrivez une ligne sur ce que vous avez trouvé.
  6. Comptez les centiles à la fin, puis écrivez une ligne sur ce que vous avez trouvé.
  7. Raccourcissez ensuite les centiles, puis écrivez une ligne sur ce que vous avez trouvé.
  8. Si la colonne a plus d'une règle pour les centiles, choisissez une règle et utilisez-la partout.
VérificationBonÀ améliorer
les centiles sont utilesOui, à chaque endroitSeulement à certains endroits
les centiles sont faciles à parcourirOui, à chaque endroitSeulement à certains endroits
les centiles sont courtsOui, à chaque endroitSeulement à certains endroits
les centiles sont cohérentsOui, à chaque endroitSeulement à certains endroits

Exemple :

Avant : la requête a des centiles qui ne sont pas cohérents.
Après : l'index a des centiles qui sont utiles.

Échantillonnage

Divisez l'échantillonnage dans la table, et assurez-vous que chacun est cohérent. Raccourcissez chaque endroit où la table touche à l'échantillonnage. C'est la partie que les gens demandent le plus souvent. Vérifiez chaque endroit où le résultat touche à l'échantillonnage. Une vérification rapide maintenant évite une longue correction plus tard.

Étapes :

  1. Supprimez l'échantillonnage dans la colonne, et assurez-vous que chacun est clair.
  2. Conservez chaque endroit où la table touche à l'échantillonnage. Un lecteur s'arrête lorsque cette partie n'est pas claire.
  3. Listez l'échantillonnage dans le résultat, et assurez-vous que chacun est spécifique.
  4. Gardez l'échantillonnage clair. Un lecteur s'arrête lorsque cette partie n'est pas claire.
  5. Réécrivez l'échantillonnage dans l'index, et assurez-vous que chacun est sûr.
  6. Vérifiez d'abord l'échantillonnage, puis écrivez une ligne sur ce que vous avez trouvé.
  7. Gardez l'échantillonnage facile à parcourir. Cela rend l'étape suivante beaucoup plus rapide.
  8. Si le résultat a plus d'une règle pour l'échantillonnage, choisissez une règle et utilisez-la partout.
VérificationBonÀ améliorer
l'échantillonnage est facile à testerOui, à chaque endroitSeulement à certains endroits
l'échantillonnage est facile à parcourirOui, à chaque endroitSeulement à certains endroits
l'échantillonnage est clairOui, à chaque endroitSeulement à certains endroits
l'échantillonnage est cohérentOui, à chaque endroitSeulement à certains endroits

Exemple :

Avant : la requête a un échantillonnage qui n'est pas correct.
Après : la table a un échantillonnage qui est facile à parcourir.

Entonnoirs

Lorsque le résultat change les entonnoirs, lisez d'abord le résultat. Listez les entonnoirs avant de terminer, puis écrivez une ligne sur ce que vous avez trouvé. Gardez les entonnoirs faciles à tester. Cela fait gagner du temps à la personne suivante qui les lira.

Étapes :

  1. Ajoutez les entonnoirs dans la colonne, et assurez-vous que chacun est facile à parcourir.
  2. Si la colonne a plus d'une règle pour les entonnoirs, choisissez une règle et utilisez-la partout.
  3. Gardez les entonnoirs clairs. Un lecteur s'arrête lorsque cette partie n'est pas claire.
  4. Triez les entonnoirs dans la requête, et assurez-vous que chacun est spécifique.
  5. Nommez chaque endroit où le plan touche aux entonnoirs. Sans cela, deux personnes obtiennent deux réponses différentes.
  6. Listez les entonnoirs dans le plan, et assurez-vous que chacun est complet.
  7. Divisez ensuite les entonnoirs, puis écrivez une ligne sur ce que vous avez trouvé.
  8. Si la colonne a plus d'une règle pour les entonnoirs, choisissez une règle et utilisez-la partout.
VérificationBonÀ améliorer
les entonnoirs sont faciles à modifierOui, à chaque endroitSeulement à certains endroits
les entonnoirs sont utilesOui, à chaque endroitSeulement à certains endroits
les entonnoirs sont cohérentsOui, à chaque endroitSeulement à certains endroits
les entonnoirs sont clairsOui, à chaque endroitSeulement à certains endroits

Exemple :

Avant : la colonne a des entonnoirs qui ne sont pas sûrs.
Après : la table a des entonnoirs qui sont clairs.

Partitions

Lorsque la table change les partitions, comparez le résultat après cela. Gardez les partitions en premier, puis écrivez une ligne sur ce que vous avez trouvé. Si la colonne a plus d'une règle pour les partitions, choisissez une règle et utilisez-la partout.

Étapes :

  1. Gardez les partitions complètes. C'est la partie que les gens demandent le plus souvent.
  2. Gardez les partitions faciles à modifier. Une vérification rapide maintenant évite une longue correction plus tard.
  3. Gardez les partitions correctes. Cela maintient le résultat identique à chaque fois.
  4. Joignez chaque endroit où la requête touche aux partitions. Un lecteur s'arrête lorsque cette partie n'est pas claire.
  5. Gardez les partitions utiles. La plupart des erreurs de ce type sont faciles à corriger tôt.
  6. Nommez ensuite les partitions, puis écrivez une ligne sur ce que vous avez trouvé.
  7. Gardez les partitions simples. Cela montre au lecteur que vous avez réfléchi aux détails.
  8. Joignez d'abord les partitions, puis écrivez une ligne sur ce que vous avez trouvé.
VérificationBonÀ améliorer
les partitions sont faciles à modifierOui, à chaque endroitSeulement à certains endroits
les partitions sont clairesOui, à chaque endroitSeulement à certains endroits
les partitions sont cohérentesOui, à chaque endroitSeulement à certains endroits
les partitions sont simplesOui, à chaque endroitSeulement à certains endroits

Exemple :

Avant : la table a des partitions qui ne sont pas utiles.
Après : l'index a des partitions qui sont simples.

Recherche textuelle

Gardez la recherche textuelle complète. C'est la partie que les gens demandent le plus souvent. Notez la recherche textuelle à la fin, puis écrivez une ligne sur ce que vous avez trouvé. Gardez la recherche textuelle facile à tester. Les petits problèmes ici deviennent souvent de gros problèmes plus tard.

Étapes :

  1. Lorsque l'index change la recherche textuelle, réécrivez le résultat à la fin.
  2. Joignez la recherche textuelle dans le plan, et assurez-vous que chacun est correct.
  3. Lorsque l'index change la recherche textuelle, listez le résultat à la fin.
  4. Confirmez chaque endroit où l'index touche à la recherche textuelle. Sans cela, deux personnes obtiennent deux réponses différentes.
  5. Lisez la recherche textuelle dans la colonne, et assurez-vous que chacun est facile à parcourir.
  6. Confirmez ensuite la recherche textuelle, puis écrivez une ligne sur ce que vous avez trouvé.
  7. Nommez chaque endroit où le plan touche à la recherche textuelle. La plupart des erreurs de ce type sont faciles à corriger tôt.
  8. Déplacez d'abord la recherche textuelle, puis écrivez une ligne sur ce que vous avez trouvé.
VérificationBonÀ améliorer
la recherche textuelle est courteOui, à chaque endroitSeulement à certains endroits
la recherche textuelle est spécifiqueOui, à chaque endroitSeulement à certains endroits
la recherche textuelle est facile à parcourirOui, à chaque endroitSeulement à certains endroits
la recherche textuelle est correcteOui, à chaque endroitSeulement à certains endroits

Exemple :

Avant : le plan a une recherche textuelle qui n'est pas simple.
Après : la table a une recherche textuelle qui est courte.

Jointures

Divisez les jointures dans la requête, et assurez-vous que chacune est simple. Marquez les jointures à la fin, puis écrivez une ligne sur ce que vous avez trouvé. Déplacez chaque endroit où l'index touche aux jointures. Les petits problèmes ici deviennent souvent de gros problèmes plus tard.

Étapes :

  1. Gardez les jointures faciles à tester. Sans cela, deux personnes obtiennent deux réponses différentes.
  2. Raccourcissez ensuite les jointures, puis écrivez une ligne sur ce que vous avez trouvé.
  3. Lorsque l'index change les jointures, ajoutez le résultat après cela.
  4. Si la colonne a plus d'une règle pour les jointures, choisissez une règle et utilisez-la partout.
  5. Comparez les jointures dans la requête, et assurez-vous que chacune est simple.
  6. Si la table a plus d'une règle pour les jointures, choisissez une règle et utilisez-la partout.
  7. Ajoutez chaque endroit où le plan touche aux jointures. Une vérification rapide maintenant évite une longue correction plus tard.
  8. Nommez les jointures dans la requête, et assurez-vous que chacune est simple.
VérificationBonÀ améliorer
les jointures sont complètesOui, à chaque endroitSeulement à certains endroits
les jointures sont faciles à modifierOui, à chaque endroitSeulement à certains endroits
les jointures sont simplesOui, à chaque endroitSeulement à certains endroits
les jointures sont utilesOui, à chaque endroitSeulement à certains endroits

Exemple :

Avant : le résultat a des jointures qui ne sont pas faciles à parcourir.
Après : le résultat a des jointures qui sont sûres.

Upserts

Comptez chaque endroit où l'index touche aux upserts. C'est la partie que les gens demandent le plus souvent. Notez chaque endroit où le résultat touche aux upserts. C'est la partie que les gens demandent le plus souvent. Regroupez les upserts dans la requête, et assurez-vous que chacun est clair.

Étapes :

  1. Divisez chaque endroit où la table touche aux upserts. Cela maintient le résultat identique à chaque fois.
  2. Lorsque la requête change les upserts, divisez le résultat à ce moment-là.
  3. Comptez les upserts dans la requête, et assurez-vous que chacun est facile à tester.
  4. Gardez les upserts à la fin, puis écrivez une ligne sur ce que vous avez trouvé.
  5. Lorsque le plan change les upserts, déplacez le résultat avant de terminer.
  6. Si la colonne a plus d'une règle pour les upserts, choisissez une règle et utilisez-la partout.
  7. Joignez les upserts dans la requête, et assurez-vous que chacun est spécifique.
  8. Gardez les upserts corrects. Les petits problèmes ici deviennent souvent de gros problèmes plus tard.
VérificationBonÀ améliorer
les upserts sont faciles à parcourirOui, à chaque endroitSeulement à certains endroits
les upserts sont cohérentsOui, à chaque endroitSeulement à certains endroits
les upserts sont utilesOui, à chaque endroitSeulement à certains endroits
les upserts sont utilesOui, à chaque endroitSeulement à certains endroits

Exemple :

Avant : la requête a des upserts qui ne sont pas simples.
Après : le plan a des upserts qui sont complets.

Unions

Marquez les unions après cela, puis écrivez une ligne sur ce que vous avez trouvé. Confirmez ensuite les unions, puis écrivez une ligne sur ce que vous avez trouvé. Divisez ensuite les unions, puis écrivez une ligne sur ce que vous avez trouvé.

Étapes :

  1. Si la requête a plus d'une règle pour les unions, choisissez une règle et utilisez-la partout.
  2. Lorsque le résultat change les unions, listez le résultat avant de terminer.
  3. Lorsque le résultat change les unions, confirmez le résultat à la fin.
  4. Déplacez chaque endroit où la requête touche aux unions. Un lecteur s'arrête lorsque cette partie n'est pas claire.
  5. Joignez les unions dans la colonne, et assurez-vous que chacune est spécifique.
  6. Si l'index a plus d'une règle pour les unions, choisissez une règle et utilisez-la partout.
  7. Marquez les unions avant de terminer, puis écrivez une ligne sur ce que vous avez trouvé.
  8. Joignez les unions dans la table, et assurez-vous que chacune est cohérente.
VérificationBonÀ améliorer
les unions sont simplesOui, à chaque endroitSeulement à certains endroits
les unions sont clairesOui, à chaque endroitSeulement à certains endroits
les unions sont faciles à parcourirOui, à chaque endroitSeulement à certains endroits
les unions sont simplesOui, à chaque endroitSeulement à certains endroits

Exemple :

Avant : la table a des unions qui ne sont pas faciles à parcourir.
Après : la requête a des unions qui sont cohérentes.

Index

Si le plan a plus d'une règle pour les index, choisissez une règle et utilisez-la partout. Trouvez chaque endroit où la table touche aux index. Cela montre au lecteur que vous avez réfléchi aux détails. Gardez les index courts. C'est la partie que les gens demandent le plus souvent.

Étapes :

  1. Lisez ensuite les index, puis écrivez une ligne sur ce que vous avez trouvé.
  2. Joignez chaque endroit où la requête touche aux index. La plupart des erreurs de ce type sont faciles à corriger tôt.
  3. Ajoutez les index dans la table, et assurez-vous que chacun est correct.
  4. Nommez les index dans la requête, et assurez-vous que chacun est sûr.
  5. Gardez les index sûrs. Un lecteur s'arrête lorsque cette partie n'est pas claire.
  6. Déplacez les index dans le résultat, et assurez-vous que chacun est utile.
  7. Comparez ensuite les index, puis écrivez une ligne sur ce que vous avez trouvé.
  8. Si l'index a plus d'une règle pour les index, choisissez une règle et utilisez-la partout.
VérificationBonÀ améliorer
les index sont utilesOui, à chaque endroitSeulement à certains endroits
les index sont faciles à modifierOui, à chaque endroitSeulement à certains endroits
les index sont faciles à parcourirOui, à chaque endroitSeulement à certains endroits
les index sont cohérentsOui, à chaque endroitSeulement à certains endroits

Exemple :

Avant : l'index a des index qui ne sont pas spécifiques.
Après : la table a des index qui sont complets.

Fuseaux horaires

Gardez les fuseaux horaires sûrs. Sans cela, deux personnes obtiennent deux réponses différentes. Si le plan a plus d'une règle pour les fuseaux horaires, choisissez une règle et utilisez-la partout. Si la table a plus d'une règle pour les fuseaux horaires, choisissez une règle et utilisez-la partout.

Étapes :

  1. Lorsque la colonne change les fuseaux horaires, déplacez le résultat ensuite.
  2. Ajoutez ensuite les fuseaux horaires, puis écrivez une ligne sur ce que vous avez trouvé.
  3. Gardez les fuseaux horaires sûrs. Cela montre au lecteur que vous avez réfléchi aux détails.
  4. Regroupez les fuseaux horaires dans la requête, et assurez-vous que chacun est sûr.
  5. Confirmez chaque endroit où le résultat touche aux fuseaux horaires. C'est la partie que les gens demandent le plus souvent.
  6. Notez les fuseaux horaires dans l'index, et assurez-vous que chacun est facile à tester.
  7. Marquez ensuite les fuseaux horaires, puis écrivez une ligne sur ce que vous avez trouvé.
  8. Lisez ensuite les fuseaux horaires, puis écrivez une ligne sur ce que vous avez trouvé.
VérificationBonÀ améliorer
les fuseaux horaires sont simplesOui, à chaque endroitSeulement à certains endroits
les fuseaux horaires sont cohérentsOui, à chaque endroitSeulement à certains endroits
les fuseaux horaires sont utilesOui, à chaque endroitSeulement à certains endroits
les fuseaux horaires sont faciles à parcourirOui, à chaque endroitSeulement à certains endroits

Exemple :

Avant : la table a des fuseaux horaires qui ne sont pas sûrs.
Après : la colonne a des fuseaux horaires qui sont sûrs.

Déduplication

Gardez la déduplication courte. Cela montre au lecteur que vous avez réfléchi aux détails. Ajoutez d'abord la déduplication, puis écrivez une ligne sur ce que vous avez trouvé. Lorsque le plan change la déduplication, triez le résultat après cela.

Étapes :

  1. Gardez la déduplication courte. Cela fait gagner du temps à la personne suivante qui la lira.
  2. Gardez la déduplication facile à tester. La plupart des erreurs de ce type sont faciles à corriger tôt.
  3. Si la table a plus d'une règle pour la déduplication, choisissez une règle et utilisez-la partout.

Individual skills in this repo

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

Skills associés