supabase-postgres-best-practices 是什麼、怎麼安裝使用：Supabase 維護的 Postgres 最佳實踐 Skill

本文根據 supabase/agent-skills 倉庫裏該技能的 SKILL.md 與倉庫 README 整理，資料核對於 2026-10-11。skills.sh 榜單當日顯示該技能累計安裝約 43.9 萬次；所在倉庫 supabase/agent-skills 在 GitHub 約 2708 Star（同日數據）。技能內容會隨倉庫更新，以倉庫為準。

這個 Skill 做什麼

讓智能體寫 SQL，它會建出沒有索引的外鍵、用錯的列類型、能跑但會鎖表的遷移，以及看似生效實則漏數據的行級安全策略。supabase-postgres-best-practices 是 Supabase 團隊維護的 Postgres 規則集，並且特別說明適用於「運行在任何地方的 Postgres」，不限於 Supabase。

它的 description 要求在編寫或修改數據庫裏的任何東西之前加載：創建或修改表和列（包括選擇列類型）、模式設計、遷移與聲明式模式文件、RLS 策略及其測試、索引、觸發器、數據庫函數、隊列與定時任務（pg_cron、pgmq）、向量檢索（pgvector）、恢復備份或導入數據；診斷慢查詢、CPU 飆高、超時、執行計劃、連接耗盡、鎖、膨脹，或「數據被不該看到的用戶看到」時也要加載。末尾還強調：這不只是性能指南，哪怕只改一列或只寫一條查詢，也需要這些規則。

規則分 8 個類別，按影響從關鍵（查詢性能、連接管理）到增量（高級特性）排序。references/ 目錄下每條規則一個文件，帶錯誤與正確的 SQL 對照和執行計劃分析，例如連接池與連接上限、批量插入、N+1、分頁、upsert、死鎖預防、JSONB 索引、全文檢索。

怎麼安裝

倉庫 README 直接給出了單獨安裝這個技能的命令：

bash
npx skills add supabase/agent-skills --skill supabase-postgres-best-practices

Claude Code 也可以走插件：先 claude plugin marketplace add supabase/agent-skills，再 claude plugin install postgres-best-practices@supabase-agent-skills。

倉庫整體介紹和其他安裝方式，詳見本站《supabase/agent-skills 是什麼、怎麼安裝：Supabase 官方 Agent Skills（Supabase 開發與 Postgres 最佳實踐）》。

怎麼用

• 「給訂單表加一個按用戶和時間查詢的索引，並寫遷移」。
• 「這條查詢要 3 秒，幫我看 EXPLAIN 結果並優化」。
• 「給多租戶表寫 RLS 策略，再寫測試驗證租戶之間互相看不到數據」。

適合誰 / 侷限

適合後端與全棧開發者，無論數據庫託管在 Supabase、雲廠商還是自建。規則針對 Postgres，MySQL 等其他數據庫不適用；它給的是通用最佳實踐，具體到你的數據量和訪問模式，仍要用真實的執行計劃驗證。

注意事項

• 許可：MIT。
• 不執行腳本：純規則文檔；但智能體依據它生成的遷移會改動數據庫，先在開發庫或分支庫上運行，生產變更務必人工審查。
• skills.sh 當日榜單顯示它是該庫安裝量更高的一個技能。