本文根據 supabase/agent-skills 倉庫裏該技能的 SKILL.md 與倉庫 README 整理,資料核對於 2026-10-11。skills.sh 榜單當日顯示該技能累計安裝約 31.9 萬次;所在倉庫 supabase/agent-skills 在 GitHub 約 2708 Star(同日數據)。技能內容會隨倉庫更新,以倉庫為準。
這個 Skill 做什麼
Supabase 迭代很快,函數簽名、config.toml 的配置項、SSR 集成的寫法隔幾個月就變,模型憑訓練記憶寫的代碼經常已經過時。supabase 技能的第一條核心原則就是針對這一點:Supabase 變化頻繁,實現之前先對照更新日誌和當前文檔核實,不要依賴訓練數據。做法是先抓取官網的 changelog 摘要索引,找與任務相關的破壞性變更標記,再去查對應文檔。
description 的觸發範圍非常寬:任何涉及 Supabase 的任務。包括各產品(Database、Auth、Edge Functions、Realtime、Storage、Vectors、Cron、Queues);客戶端庫與 SSR 集成(supabase-js、@supabase/ssr,在 Next.js、React、SvelteKit、Astro、Remix 中);認證問題(登入登出、會話、JWT、Cookie、RLS);Supabase CLI 與 MCP 伺服器;模式變更、遷移、安全審計、Postgres 擴展;以及各種報錯排查和日誌查詢。
第二條原則是「驗證你的工作」。其餘部分講 CLI 與 MCP 伺服器怎麼用、文檔怎麼查、模式變更的兩種做法(聲明式模式與命令式遷移)以及調試方法。
怎麼安裝
倉庫 README 直接給出了單獨安裝這個技能的命令:
bash
npx skills add supabase/agent-skills --skill supabase
Claude Code 也可以走插件:先 claude plugin marketplace add supabase/agent-skills,再 claude plugin install supabase@supabase-agent-skills。
倉庫整體介紹和其他安裝方式,詳見本站《supabase/agent-skills 是什麼、怎麼安裝:Supabase 官方 Agent Skills(Supabase 開發與 Postgres 最佳實踐)》。
怎麼用
- 「給這個 Next.js 項目接入 Supabase Auth,用服務端渲染的方式處理會話」。
- 「用戶反饋登入後偶爾被踢出,幫我排查」——它會查日誌並對照當前文檔裏會話處理的寫法。
- 「新增一張表並提交遷移」——按項目已有的方式(聲明式或遷移文件)來做。
目錄裏另有反饋模板:技能鼓勵你把它出錯的地方反饋給 Supabase。
適合誰 / 侷限
適合所有用 Supabase 做後端的開發者,與同庫的 Postgres 最佳實踐技能搭配使用效果最好:這個管平台用法,那個管數據庫本身。它依賴聯網查文檔,離線環境裏效果打折;不用 Supabase 的項目用不上。
注意事項
- 許可:MIT。
- 會聯網:按設計要抓取官方更新日誌和文檔。
- 權限:配合 Supabase CLI 或 MCP 伺服器時,智能體能直接操作你的項目。給它開發環境的憑據,生產庫的變更人工執行;不要把 service role 密鑰貼進對話或提交進倉庫。
- 費用:技能免費,Supabase 資源用量按其套餐計。
0 條評論
還沒有評論,來搶沙發~