supabase

supabase 技能概覽

supabase 技能是用來做什麼的

supabase 技能適合你用 local-first 的工作流程來處理 Supabase 驅動的應用：資料庫變更、驗證、儲存空間、Edge Functions，以及透過 migrations 部署，而不是手動去改正式環境。它最適合需要實用 supabase 指南來做後端開發的讀者，而不是只想看一段 PostgreSQL 泛用提示詞的人。

誰應該安裝它

如果你正在開發或維護一個已經使用 Supabase 的專案，或者你需要把粗略的產品想法整理成有結構的本機開發流程，就很適合使用這個 supabase 技能。當你在意 schema 變更、RLS、環境設定，以及如何讓本機與遠端狀態保持一致時，它尤其有用。

它的差異在哪裡

它的主要價值在流程，而不是理論：supabase 安裝指引、CLI 設定、連結遠端專案，以及有紀律的 migration 流程。當你想減少臨時性的資料庫操作、改用更可重複的變更方式時，它會比自由發揮式提示更適合。

如何使用 supabase 技能

先安裝並打開正確的檔案

先把技能安裝到你的 skills 目錄，接著從 SKILL.md 和專案的 supabase/ 資料夾開始看起。就這個 repo 來說，沒有輔助腳本或額外的參考資料夾，所以第一輪閱讀應該聚焦在核心說明，不要花時間去找不存在的隱藏工具。

給技能正確的輸入

想要最佳結果，提示詞要明確寫出你要處理的 Supabase 工作、專案類型，以及任何限制條件。好的輸入像是：「替 SaaS app 加上帶 RLS 的 profiles table」、「建立一個用來驗證 webhook 的 Edge Function」、或「診斷為什麼本機 auth 正常，但遠端登入失敗」。像「修 Supabase」這種模糊輸入，通常只會得到很泛的回覆。

依照 local-first 工作流程來做

使用這個技能時，先在本機規劃變更：初始化 Supabase、把 schema 修改寫成 migrations、用 CLI 測試，等本機結果正確之後再 link 和 push。如果你在處理既有專案，先請技能判斷在改動前是否應該先查看 supabase/config.toml、supabase/migrations/ 和 supabase/seed.sql。

先讀這些來源

先看 SKILL.md，如果你需要命令層級的細節，再去看裡面連結的 Supabase CLI 文件。若是你自己的專案，則優先查看 supabase/config.toml、既有 migrations、seed data，以及技能路徑中提到的任何環境檔。這些檔案通常決定了輸出到底能不能真的用。

supabase 技能常見問答

supabase 只適合後端開發嗎？

大致上是。supabase 技能最強的地方在後端開發任務，例如資料庫設計、RLS、驗證流程、儲存政策，以及 Edge Functions。它不能完全取代前端架構方面的協助。

使用前一定要先懂 Supabase 嗎？

不需要，但你要能清楚描述自己想要的結果。只要你能說明需要哪個 table、policy、function 或 auth flow，這個技能對初學者也算友善。如果你連資料模型或存取規則都定義不清楚，通常就得花更多時間反覆修正提示詞。

這和一般提示詞有什麼不同？

一般提示詞可能只是各自解釋 Supabase 功能。這個 supabase 技能的目的是引導實作決策：怎麼在本機設定、怎麼維持 migrations 乾淨、以及怎麼避免直接改正式環境。當你要的是可運作的變更，而不只是概念解釋時，它會更有用。

什麼情況不該用這個技能？

如果你只是問一個一次性的概念問題，沒有專案背景，就不適合用它；如果你的技術棧其實不是以 Supabase 為基礎，也不適合。若你要的是以 UI 為主的前端工作，而且完全不涉及資料庫、auth 或 function 變更，它也不是好選擇。

如何改進 supabase 技能

明確指出你要碰的 Supabase 範圍

最有效的改進方式，是直接點名你要處理的範圍：資料庫 schema、RLS policies、auth 設定、storage buckets、realtime subscriptions，或 Edge Functions。任務範圍越精準，技能需要猜測的部分就越少，輸出也會越有用。

在要求變更前先提供目前狀態

如果 table、policy 或 function 已經存在，請把目前的 SQL、migration 名稱，或錯誤訊息一起附上。這很重要，因為 supabase 的使用常常卡在本機與遠端狀態的交界，而技能只有知道哪些內容已經部署，才能真正幫上忙。

要求可直接執行的實作，而不只是建議

請直接要求具體產物：migration SQL、policy definitions、CLI commands，或一步一步的 supabase 安裝與部署流程。如果第一個回覆太廣，就再縮小要求，例如改成「把這段改寫成 migration」或「只補上缺少的 RLS policy」。

注意常見失敗模式

最常見的問題是提示詞太模糊、缺少專案背景，以及把本機與 production 變更混在同一個要求裡。若你想從 supabase 技能拿到可靠結果，就要把環境資訊清楚放出來、不要假設預設 policy 一定適用，並明確說明目標是 greenfield 專案還是既有的 Supabase app。