mcpField
S
supabase-postgres-best-practices

supabase-postgres-best-practices

公式
github.com/supabaseデータ・データベース2.9k464.3k 回インストール4 週間前に更新
リポジトリ

supabase-postgres-best-practices について

Supabase が管理する Postgres のパフォーマンス最適化ガイドで、エージェントスキールとして提供されています。ルールは影響度順の 8 つのカテゴリに分かれ、クエリ、接続、RLS、スキーマ設計などを扱います。データベースのコードを書く、またはレビューする開発者向けです。

主な機能

  1. 01影響度順に並んだ 8 つのルールカテゴリ
  2. 02クエリとインデックスの最適化ガイダンス
  3. 03接続管理とコネクションプーリングのルール
  4. 04Row-Level Security のルール
  5. 05ルールごとの誤りと正しい SQL の例

活用シーン

  1. 01SQL の記述やスキーマ設計時のルール参照
  2. 02データベースのパフォーマンス問題のレビュー
  3. 03コネクションプーリングの設定やスケーリング計画
#databases

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/supabase/agent-skills --skill supabase-postgres-best-practices

インストール後、Claude Code で/supabase-postgres-best-practicesを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

CHANGELOG.md
references/
_contributing.md
_sections.md
_template.md
advanced-full-text-search.md
advanced-jsonb-indexing.md
conn-idle-timeout.md
conn-limits.md
conn-pooling.md
conn-prepared-statements.md
data-batch-inserts.md
data-n-plus-one.md
data-pagination.md
data-upsert.md
lock-advisory.md
lock-deadlock-prevention.md
lock-short-transactions.md
lock-skip-locked.md
monitor-explain-analyze.md
monitor-pg-stat-statements.md
monitor-vacuum-analyze.md
query-composite-indexes.md
query-covering-indexes.md
query-index-types.md
query-missing-indexes.md
query-partial-indexes.md
schema-constraints.md
schema-data-types.md
schema-foreign-key-indexes.md
schema-lowercase-identifiers.md

詳細

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 の例については、個々のルールファイルを参照してください。

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

各ルールファイルには、以下が含まれています。

  • 重要である理由の簡潔な説明
  • 説明付きの不適切な SQL の例
  • 説明付きの適切な SQL の例
  • 任意の EXPLAIN 出力またはメトリクス
  • 追加の背景情報と参考資料
  • Supabase 固有の注記（該当する場合）

参考資料

コメント

Markdown 対応