SKILL ARTICLE / supabase-postgres-best-practices
Supabase Postgres Best Practicesとは？ 実践知を優先順位つきで使うSkill
SQLの正しさだけでなく、本番での振る舞いを点検する。
Supabaseの知見をもとに、Postgresのクエリ、スキーマ、インデックス、接続などをレビューするSkillです。
OVERVIEW → CAN DO → BUILD
知ったことをSkillづくりに活かす
動くSQLと、負荷やデータ量が増えても安全なSQLは同じではない。レビュー観点を繰り返し適用できる形にしている。
性能問題や運用上の落とし穴を、リリース前に見つける。
このSkillは知識を並べるだけでなく、8分野と影響度で整理し、必要なルールへ進める入口を作っています。自分たちのSkillでも、情報量が多い分野ほど、利用場面、重要度、ファイル名の規則などを先に示すと...
01 / OVERVIEW
Skillの概要
Supabase Postgres Best Practicesは、Postgresの性能と安全な運用に関する知識を、AIが参照しやすいルール集にしたSkillです。内容は、クエリ性能、接続管理、セキュリティとRLS、スキーマ設計、ロックと並行処理、データアクセス、監視、高度な機能という8分野に分かれています。さらに、影響の大きい分野から確認できるよう優先順位が付けられています。
個々のルールは別ファイルになっており、理由、望ましくないSQL、改善例、必要に応じて実行計画や性能指標、Supabase固有の注意点を読む構成です。長い知識集を一度に渡すのではなく、作業に関係するルールだけを取り出せるよう設計されています。
02 / CAN DO
できるようになること
SQLやスキーマをレビューするとき、まず重要度の高いクエリ性能、接続管理、RLSを確認し、その後にスキーマやロックへ進みます。指摘にはルールの理由と改善例を添えられるため、単なる好みと、運用上の問題を分けて話しやすくなります。
ただし、一般的なベストプラクティスだけで個別システムの性能を断定することはできません。実際のデータ量、アクセス傾向、実行計画、計測値を確認して初めて判断できる項目もあります。
活かしやすい場面
- 新しいテーブルやインデックスの設計
- 遅いクエリの原因整理
- DB変更を含むPRレビュー
使う前に確認したい場面
- 実行計画や本番メトリクスを見ずに断定する性能診断
- バックアップなしの本番DDL実行
03 / BUILD
自分たちのSkill作成に活かせること
文章やコードをそのまままねるのではなく、自分たちのSkillに取り入れたい判断基準や工程の分け方を整理しました。
専門知識に、探すための地図を付ける
このSkillは知識を並べるだけでなく、8分野と影響度で整理し、必要なルールへ進める入口を作っています。自分たちのSkillでも、情報量が多い分野ほど、利用場面、重要度、ファイル名の規則などを先に示すと、AIが関係する知識だけを選びやすくなります。
一つのルールを、同じ型で読めるようにする
理由、悪い例、改善例、測定方法、補足という共通構造は、知識を実際のレビューへ変換しやすくします。社内のノウハウをSkill化するときも、「原則」だけで終わらせず、適用条件、反例、改善例、確認方法を一組にすると、AIが具体的な提案へ落とし込みやすくなります。
助言と実測が必要な判断を分ける
ルールには実行計画や性能指標を扱う余地があり、一般論だけで終わらない構成になっています。自分たちのSkillでは、知識から指摘できることと、実データを測らなければ分からないことを明記し、後者には確認コマンドや必要な入力を返させると、過剰な断定を減らせます。
04 / WORKFLOW
実際に使うときの流れ
- 01
前提を収集
データ量、読み書き比、SLA、実行環境を確認する。
- 02
観点別に点検
クエリ、インデックス、権限、接続、ロックを見る。
- 03
実測で確認
実行計画や代表データで仮説を検証する。
05 / TRY
試すときに使える依頼文
最初は、結果を自分で確かめやすい題材に使ってみてください。Skillがどこまで判断できるのか、どこで人の確認が必要なのかがわかります。
このDB変更を、想定データ量・読み書き比率・ロック・ロールバックの観点でレビューしてください。根拠が実測を必要とする箇所は断定せず、確認コマンドを提案してください。06 / INSTALL
導入方法を確認する
コマンドや配置方法は更新されることがあります。実行する前に、公開元の最新READMEとライセンスを確認してください。
npx skills add supabase/agent-skills --skill supabase-postgres-best-practices$skill-installer install https://github.com/supabase/agent-skills/tree/main/skills/supabase-postgres-best-practices07 / WATCHOUTS
人が確認するところ
- 本番DBへの変更は、バックアップ・ロック時間・ロールバック方法を確認してください。
- 一般的なベストプラクティスより、実際の負荷と実行計画を優先してください。