mcpField
S
supabase-postgres-best-practices

supabase-postgres-best-practices

github.com/laguaguデータ・データベース71138 回インストール1 日前に更新
リポジトリ

supabase-postgres-best-practices について

Supabase Postgres Best Practicesは、Supabaseが管理するクエリ最適化とデータベース設計のリファレンススキルです。優先度付きのルールで、性能、接続、セキュリティ、スキーマなどを扱い、個別の推奨事項にSQL例を示します。

主な機能

  1. 01Postgresに関する8カテゴリの指針
  2. 02影響度順に並ぶルール
  3. 03各ルールのSQL例
  4. 04RLSとコネクションプーリングの解説
  5. 05クエリとVACUUMの診断

活用シーン

  1. 01遅いSQLクエリの最適化
  2. 02インデックスとスキーマの設計
  3. 03RLSとデータベースセキュリティの確認
  4. 04接続やVACUUMの問題調査

インストール

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

$npx skills add https://github.com/laguagu/claude-code-nextjs-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)を扱う

クイック判断ツリー

Problem?
├─ Slow query → query-missing-indexes, query-composite-indexes, monitor-explain-analyze
├─ Connection errors / timeouts → conn-pooling, conn-limits, conn-idle-timeout
├─ Deadlocks / long transactions → lock-short-transactions, lock-deadlock-prevention
├─ Bulk load slow → data-batch-inserts, data-upsert
├─ Table bloat / VACUUM issues → monitor-vacuum-analyze
├─ JSONB queries slow → advanced-jsonb-indexing
├─ FTS / search quality → advanced-full-text-search (pair with /postgres-semantic-search for BM25 + vector)
└─ Security / multi-tenant → security-* rules, RLS

関連スキル

  • /postgres-semantic-search — ベクトル検索(pgvector)、ハイブリッド BM25 + セマンティック検索、ParadeDB
  • /nextjs-chatbot — チャットボットのオーケストレーション、セッション DB、フィードバック、HITL
  • /ai-sdk — バックエンド統合向けの AI SDK パターン

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

優先度カテゴリ影響度接頭辞
1クエリパフォーマンスCRITICALquery-
2コネクション管理CRITICALconn-
3セキュリティと RLSCRITICALsecurity-
4スキーマ設計HIGHschema-
5並行性とロックMEDIUM-HIGHlock-
6データアクセスパターンMEDIUMdata-
7モニタリングと診断LOW-MEDIUMmonitor-
8高度な機能LOWadvanced-

使用方法

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

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

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

  • 重要な理由についての簡単な説明
  • 説明付きの誤った SQL の例
  • 説明付きの正しい SQL の例
  • 必要に応じて EXPLAIN の出力またはメトリクス
  • 追加の背景情報と参考資料
  • Supabase 固有の注意事項(該当する場合)

参考資料

コメント