supabase/agent-skills 是什麼、怎麼安裝：Supabase 官方 Agent Skills（Supabase 開發與 Postgres 最佳實踐）

本文根據 supabase/agent-skills 倉庫 README、Supabase 官方文檔的 AI Skills 頁面和 Claude Code 官方文檔整理，資料核對於 2026-10-10。

是什麼

supabase/agent-skills 是 Supabase 官方維護的技能倉庫，目的很單純：讓編程智能體在用 Supabase 和 Postgres 時寫得更準。智能體常見的毛病是沿用舊版 SDK 寫法、忘記開行級安全策略、建表不加索引，這個倉庫把 Supabase 團隊認可的做法寫成技能，交給智能體在相關任務裏參考。技能遵循 agentskills.io 的開放標準，結構是一個 SKILL.md 加可選的 references/ 參考文件。

截至 2026-10-10，GitHub 顯示該倉庫 2705 Star、218 Fork，最近一次推送 2026-10-02。Star 數不算高，但它是 Supabase 官方出品，Supabase 文檔站也有對應的安裝說明頁。

包含哪些 Skill

目前只有兩個，貴精不貴多：

• supabase：綜合技能，覆蓋 Supabase 的各個產品和集成。適用場景包括：
• 使用 Database、Auth、Edge Functions、Realtime、Storage、Vectors、Cron、Queues 任意一項；
• 在 Next.js、React、SvelteKit、Astro、Remix 裏用 supabase-js 和 @supabase/ssr 做服務端渲染集成；
• 排查登入、會話、JWT、Cookie、行級安全（RLS）相關的問題；
• 使用 Supabase CLI 或 MCP 伺服器；
• 做表結構變更、遷移、安全檢查，或用 pg_graphql、pg_cron、pg_vector 等擴展。
• supabase-postgres-best-practices：Postgres 性能優化規則，分 8 類並按影響程度排序——查詢性能、連接管理、安全與 RLS 排在最關鍵一檔，其後是表結構設計、並發與鎖、數據訪問模式、監控診斷和高級特性。寫 SQL、設計表、加索引、配連接池時都會用到，不用 Supabase 而只用 Postgres 的項目也適用。

怎麼安裝

全部安裝（README 首選）：

bash
npx skills add supabase/agent-skills

只裝其中一個：

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

作為 Claude Code 插件安裝（在終端裏執行）：

bash
claude plugin marketplace add supabase/agent-skills
claude plugin install supabase@supabase-agent-skills
claude plugin install postgres-best-practices@supabase-agent-skills

第一條登記插件市場，後兩條按需安裝。更細的說明見 Supabase 文檔的 AI Skills 頁面。README 沒有提供 claude.ai 上載 ZIP 或 Codex 專用的安裝步驟，這兩種情況可以用 npx skills 並選擇對應的智能體。

怎麼用

裝好就生效，智能體識別到相關任務會自動調用。README 給的示例說法大意是：

• 「優化這條 Postgres 查詢」；
• 「檢查我的表結構有沒有性能問題」；
• 「幫我在 Next.js 裏接好 Supabase Auth」；
• 「給這張表加上合適的索引」。

實際使用時，把報錯訊息、表結構或慢查詢的執行計劃一起貼給智能體，規則才對得上號。在 Claude Code 裏可以用 /skills 查看技能是否已加載。

適合誰 / 不適合誰

適合：

• 用 Supabase 做後端的獨立開發者和小團隊；
• 用 AI 寫 SQL、設計表結構，想多一道 Postgres 規範把關的人；
• 被登入態、RLS 策略這類問題反覆卡住的前端開發者。

不適合：

• 用 MySQL、MongoDB 等其他數據庫的項目；
• 期待一大批現成工作流的人——這裏只有兩個知識型技能，不含自動化腳本套件。

注意事項

• 許可證：MIT，倉庫根目錄有 LICENSE 文件。
• 維護狀態：最近一次推送 2026-10-02，按版本發佈，仍在維護。
• 安全：技能本身以說明和參考文檔為主，但它會指導智能體使用 Supabase CLI 和 MCP 伺服器，這意味着智能體可能對數據庫執行遷移或改動。先在開發分支或測試項目上操作，生產庫的變更要自己過目；不要把高權限的服務端密鑰直接交給智能體。第三方改寫的同名技能，安裝前照例通讀 SKILL.md。
• 兼容性：README 稱兼容 Claude Code、GitHub Copilot、Cursor、Cline 等十多種智能體，這是它自己的說法，具體以你所用工具對 Agent Skills 的支持情況為準。Supabase 產品更新快，規則與官方文檔不一致時以文檔為準。