postgres-best-practices

Supabase Postgres のベストプラクティス

Supabase に帰属するコミュニティ提供の Postgres ガイドです。上流でのメンテナンス状況およびパフォーマンスの数値例は、独立した認証を受けていません。8 つのカテゴリにわたるルールが含まれており、影響度に基づいて優先順位が付けられ、自動クエリ最適化とスキーマ設計を支援します。

使用するタイミング

次の作業を行う際に、これらのガイドラインを参照してください。

• SQL クエリの作成やスキーマの設計
• インデックスの実装やクエリの最適化
• データベースのパフォーマンス問題の確認
• 接続プーリングやスケーリングの設定
• Postgres 固有の機能に合わせた最適化
• 行レベルセキュリティ（RLS）の使用

優先度別のルールカテゴリ

優先度	カテゴリ	影響度	プレフィックス
1	クエリパフォーマンス	重大	query-
2	接続管理	重大	conn-
3	セキュリティと RLS	重大	security-
4	スキーマ設計	高	schema-
5	同時実行とロック	中〜高	lock-
6	データアクセスパターン	中	data-
7	監視と診断	低〜中	monitor-
8	高度な機能	低	advanced-

使用方法

詳細な説明と SQL の例については、個々のルールファイルを参照してください。

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

各ルールファイルには、次の内容が含まれています。

• ルールが重要な理由の簡単な説明
• 説明付きの誤った SQL の例
• 説明付きの正しい SQL の例
• 任意の EXPLAIN 出力またはメトリクス
• 追加の背景情報と参考資料
• Supabase 固有の注記（該当する場合）

完全版ドキュメント

すべてのルールを詳述したガイドの完全版：AGENTS.md

使用するタイミング

このスキルは、概要で説明されているワークフローまたはアクションを実行する場合に適用できます。

制限事項

• このスキルは、タスクが上記の範囲に明確に合致する場合にのみ使用してください。
• 出力を、環境固有の検証、テスト、または専門家によるレビューの代わりとして扱わないでください。
• 必要な入力、権限、安全上の境界、または成功基準が不足している場合は、作業を中断して確認してください。