supabase-python

supabase-python 技能概覽

supabase-python 是拿來做什麼的

supabase-python 技能能幫你用 FastAPI、Supabase Auth，以及 SQLAlchemy/SQLModel 建立 Python 後端。它最適合那些希望讓 Supabase 服務發揮長處，但核心應用資料仍想在 Python 端以直接、具型別安全的方式存取資料庫的團隊。

適合誰使用

如果你正在串接 API、加入登入／工作階段流程，或把驗證／儲存與關聯式資料存取拆開，supabase-python 技能就很適合你。對於 Python 後端開發來說，它比起只問一個關於 Supabase 的泛用提示，更像是一份實用的 Supabase Python 指南。

它最佳化的是什麼

它的主要模式很清楚：查詢交給 SQLAlchemy/SQLModel，驗證、儲存與即時功能交給 Supabase。當你重視可維護的 API 程式碼、可預測的資料庫存取，以及更少「魔法式」ORM 假設時，這個技能就特別有用。

什麼情況適合、什麼情況不適合

它最適合搭配 Supabase 後端的 FastAPI 應用。如果你的整個應用都活在 Supabase client 呼叫之中，或你需要偏前端優先的工作流程，它的價值就會比較有限。若你不是用 FastAPI，或你不想在 Python 端建立資料模型，這個技能的適用範圍也會比一般 Supabase 提示更窄。

如何使用 supabase-python 技能

正確安裝並掛載

先依照 repo 的技能安裝流程操作，然後把這個技能對應到一個帶有 FastAPI API 層、且使用 Supabase 的 Python 專案。典型的安裝指令如下：
npx skills add alinaqi/claude-bootstrap --skill supabase-python

給它一份正確的起始說明

supabase-python 的安裝效果最好，當你的提示一開始就講清楚三件事：你的技術棧、資料庫／驗證如何分工、以及你要做的功能。例如：「替這個 FastAPI app 加上 Supabase email 登入，使用 SQLModel 儲存使用者資料，並把上傳的大頭貼放到 Supabase Storage。」這會比單純說「幫我設定 Supabase」有用得多。

先讀對的檔案

先看 SKILL.md，再視情況檢查 README.md 或任何 repo 專屬文件，接著查看 pyproject.toml、src/main.py、src/core/config.py、src/db/models.py、src/api/deps.py，以及任何 supabase/ migration 或設定檔。這個 repository 裡沒有額外的 rules 或 resources 資料夾，所以主要價值就來自 skill 本體與你的專案檔案。

用符合這個技能的工作流程

一個好的 supabase-python 工作流程是：先定義驗證需求、再對應資料庫實體、決定哪些資料留在 Postgres、哪些交給 Supabase 服務，最後才實作路由與依賴注入。若你一次把所有事情都丟進去，輸出內容更容易把驗證、儲存與資料庫存取混成一個脆弱的模式。

supabase-python 技能 FAQ

supabase-python 只適合 FastAPI 專案嗎？

是的，這就是它的設計重心。這個技能是圍繞 FastAPI 模式撰寫的，所以如果你的應用是 Django、Flask，或其他 async 技術棧，你就需要調整這份指引，而不是照單全收。

它比一般提示好在哪裡？

一般提示通常只會說「做 Supabase 整合」，結果容易產生模糊或混雜的架構。supabase-python 技能把 Supabase 的驗證／儲存，和 Python 的資料模型設計分得更清楚，而這通常正是導入時最容易卡住的地方。

一定要用 SQLModel 嗎？

不一定，但這個技能是以 SQLAlchemy/SQLModel 的具型別安全資料庫存取為核心設計的。如果你已經在用原生 SQL 或其他 ORM，這個技能在概念層面仍然有幫助，但部分實作細節就不會那麼容易直接套用。

這個技能適合新手嗎？

如果你已經懂基本的 Python 和 FastAPI，它對新手算友善。但它不是 Supabase 或 SQLModel 的完整教學，因此新手應該預期自己要補一些專案背景資訊，也要準備好把生成的程式碼對照既有的應用結構來檢查。

如何改進 supabase-python 技能

先講清楚哪些資料放哪裡

最好的結果來自你把需求拆成驗證、關聯式資料、檔案儲存三部分。比方說，直接指定「Supabase 負責登入和個人頭像上傳；SQLModel 負責 posts、comments 和 permissions。」這樣可以避免 supabase-python 技能對資料存放位置做出不理想的預設。

先提供 schema 與路由意圖

如果你想要的是能直接用的後端程式碼，第一次提問就該附上模型名稱、關鍵欄位和路由行為。像是「User 有 id、email、role；建立 /auth/callback 和 /users/me 端點；強制角色權限控管」會比泛泛地要求整合更有可執行性。

注意常見失敗模式

最常見的失敗模式，是對本來應該透過資料庫層查詢的資料，過度使用 Supabase client 呼叫。若第一版輸出在模型定義或依賴注入上顯得太薄弱，就要要求這個技能往 SQLAlchemy/SQLModel 的持久化設計回收，並把 Supabase 保留給驗證、儲存與即時功能。

依照專案限制反覆調整

如果你已經有既有 migration、環境變數慣例，或非同步 session 模式，第二輪之前就要先說明。supabase-python 技能在被迫對齊你現有 codebase 時會表現得更好，而不是重新發明一套新的，尤其在後端開發裡，整合細節往往比範例程式更重要。