Supabase Postgres ベストプラクティス

Supabase によって管理される、Postgres の包括的なパフォーマンス最適化ガイド。自動クエリ最適化とスキーマ設計をガイドするため、影響度の優先順位に基づいて 8 つのカテゴリにわたるルールを含みます。

使用時期

以下の場合にこれらのガイドラインを参照してください：

• SQL クエリを書いたりスキーマを設計したりする場合
• インデックスの実装やクエリの最適化を行う場合
• データベースのパフォーマンスの問題をレビューする場合
• コネクションプーリングまたはスケーリングを設定する場合
• Postgres 固有機能に対して最適化する場合
• Row-Level Security (RLS) を使用する場合

ルールカテゴリの優先順位別一覧

優先度	カテゴリ	影響度	プレフィックス
1	クエリパフォーマンス	CRITICAL	query-
2	コネクション管理	CRITICAL	conn-
3	セキュリティ & RLS	CRITICAL	security-
4	スキーマ設計	HIGH	schema-
5	並行実行 & ロック	MEDIUM-HIGH	lock-
6	データアクセスパターン	MEDIUM	data-
7	監視 & 診断	LOW-MEDIUM	monitor-
8	高度な機能	LOW	advanced-

使用方法

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

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

各ルールファイルには以下が含まれます：

• 重要である理由の簡潔な説明
• 説明付きの間違った SQL の例
• 説明付きの正しい SQL の例
• オプションの EXPLAIN 出力またはメトリクス
• 追加の文脈と参考資料
• Supabase 固有の注記（該当する場合）

完全なコンパイル済みドキュメント

すべてのルールを展開した完全なガイドについては：AGENTS.md

使用時期

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

制限事項

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