PhuongDeveloper/landingpage

Bonnes pratiques PostgreSQL maintenues par Supabase, pour PostgreSQL exécuté n'importe où. Chargez cette compétence AVANT d'écrire ou de modifier quoi que ce soit qui vit dans une base de données PostgreSQL : création ou modification de tables et de colonnes (y compris le choix des types de colonnes), conception de schémas, migrations et fichiers de schéma déclaratifs, politiques RLS et les tests qui les vérifient, index, déclencheurs, fonctions de base de données, files d'attente et tâches planifiées (pg_cron, pgmq), recherche vectorielle/sémantique (pgvector), et restauration de dumps (pg_restore) ou importation de données. Chargez-la également lors du diagnostic de requêtes lentes, de CPU élevé, de timeouts, de plans EXPLAIN, d'épuisement des connexions, de verrous, de bloat, ou de lignes visibles par le mauvais utilisateur ou locataire. Ce n'est pas seulement un guide de performance : les tâches de schéma, migration, sécurité et rédaction SQL ont également besoin de ces règles, même pour un changement d'une seule colonne ou une requête unique.

Qu'est-ce que landingpage ?

Cette compétence est un guide complet des bonnes pratiques PostgreSQL maintenu par Supabase, conçu pour aider les développeurs et les agents IA à optimiser les performances, la sécurité et la conception des bases de données PostgreSQL, quel que soit l'environnement d'exécution. Elle couvre huit catégories prioritaires allant de la performance des requêtes et de la gestion des connexions (critiques) aux fonctionnalités avancées (faible priorité). Chaque règle est documentée dans un fichier séparé avec des exemples SQL corrects et incorrects, des plans EXPLAIN, et des notes spécifiques à Supabase. La compétence est recommandée avant toute opération de création/modification de schéma, migration, implémentation de RLS, ou diagnostic de problèmes de performance. Elle supporte des plateformes comme Claude Code, Cursor et Codex, et utilise des préfixes comme `query-`, `conn-` ou `security-` pour organiser les règles.

Compatible avec~Claude Code~Codex CLI~Cursor

npx skills add https://github.com/PhuongDeveloper/landingpage/tree/HEAD/.agents/skills/supabase-postgres-best-practices

Documentation

Bonnes pratiques PostgreSQL de Supabase

Guide complet d'optimisation des performances pour PostgreSQL, maintenu par Supabase. Contient des règles réparties en 8 catégories, priorisées par impact pour guider l'optimisation automatisée des requêtes et la conception de schémas.

Quand l'appliquer

Référez-vous à ces directives lorsque :

Vous écrivez des requêtes SQL ou concevez des schémas
Vous implémentez des index ou optimisez des requêtes
Vous examinez des problèmes de performance de base de données
Vous configurez le pooling de connexions ou le scaling
Vous optimisez pour des fonctionnalités spécifiques à PostgreSQL
Vous travaillez avec la sécurité au niveau des lignes (RLS)

Catégories de règles par priorité

Priorité	Catégorie	Impact	Préfixe
1	Performance des requêtes	CRITIQUE	`query-`
2	Gestion des connexions	CRITIQUE	`conn-`
3	Sécurité et RLS	CRITIQUE	`security-`
4	Conception de schéma	HAUT	`schema-`
5	Concurrence et verrous	MOYEN-HAUT	`lock-`
6	Schémas d'accès aux données	MOYEN	`data-`
7	Surveillance et diagnostic	FAIBLE-MOYEN	`monitor-`
8	Fonctionnalités avancées	FAIBLE	`advanced-`

Comment l'utiliser

Lisez les fichiers de règles individuelles pour obtenir des explications détaillées et des exemples SQL :

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

Chaque fichier de règle contient :

Une brève explication de pourquoi c'est important
Un exemple SQL incorrect avec explication
Un exemple SQL correct avec explication
Une sortie EXPLAIN ou des métriques optionnelles
Contexte supplémentaire et références
Notes spécifiques à Supabase (le cas échéant)