supabase-node

supabase-node 技能總覽

supabase-node 是用來做什麼的

supabase-node 技能是一份建立指南，協助你用 Supabase 和 Drizzle ORM 打造 Node.js 後端。它最適合想把 Supabase Auth 和儲存功能納入技術棧、但仍偏好用 Drizzle 進行型別化資料庫查詢，並搭配 Express 或 Hono 當 API 層的團隊。

哪些人應該安裝它

如果你正在從零開始建立新的後端、在既有 Node 服務中加入驗證，或想在 Supabase 支援的應用裡統一路由、中介層與資料庫模式，就很適合使用 supabase-node 技能。它特別適合後端開發工作，因為你需要清楚區分驗證、資料存取與請求驗證的責任邊界。

它有什麼不同

這個技能的核心設計選擇很簡單：Drizzle 負責查詢，Supabase 負責驗證與儲存，中介層負責驗證輸入。這種分工能減少臨時性的 prompt 輸出，也有助於避免把資料庫存取模式和驗證邏輯混在一起。當你需要的是可重複套用的專案結構，而不只是一次性的 prompt，這個技能的價值會更高。

如何使用 supabase-node 技能

安裝並把它放進上下文

先透過你的技能管理器執行 supabase-node install 流程，接著在處理後端任務時讓這個技能保持啟用。下提示詞時，務必讓模型同時看得到技能說明與符合目標的 repo 檔案，尤其是 src/routes/、src/middleware/、src/db/ 與 supabase/ 底下的內容。

給技能正確的任務形狀

supabase-node usage 在你的需求同時說清楚 API 層、驗證需求與資料形狀時，效果最好。舉例來說，不要只說「做一個 posts API」，而是改成「新增一個受保護的 POST /posts 路由，使用 Supabase JWT 驗證、Drizzle insert，並針對 title/body 欄位做請求驗證」。這樣技能才有足夠結構去選對檔案與邊界。

先讀這些檔案

先從 SKILL.md 開始確認模式，再檢視 src/index.ts、src/routes/index.ts、src/middleware/auth.ts、src/middleware/validate.ts、src/db/schema.ts 與 src/lib/supabase.ts。如果 repository 有 migrations，在新增資料表或任何與驗證相關的邏輯之前，先查看 supabase/migrations/。

產出品質更好的工作流程

用三步循環：先辨識路由或功能，再確認驗證與資料庫路徑，最後只實作最小、且符合既有結構的變更。supabase-node guide 在你一次只要求一種流程時最強，例如「建立 session-based auth middleware」、「新增 users 的 Drizzle query layer」，或「把 Hono route 接到 Supabase 支援的 profile 查詢」。

supabase-node 技能 FAQ

supabase-node 只適合新專案嗎？

不是。它很適合 greenfield app，但也同樣適用於需要更乾淨 Supabase 整合的既有 Node 後端。主要限制是，你的專案最好本來就習慣使用 Express 或 Hono，並搭配 TypeScript 風格的後端結構。

它和一般 prompt 有什麼不同？

一般 prompt 也可能產生可運作的程式碼，但 supabase-node 技能會提供更可靠的架構分工：驗證放哪裡、查詢放哪裡、驗證輸入放哪裡。當你想要的是可維護的 supabase-node for Backend Development，而不是快速原型時，這點就很重要。

我需要把技能的每一部分都用上嗎？

不用。如果你的 app 只需要驗證檢查和少量查詢，可以只採用核心模式，不必照單全收所有路由或資料夾慣例。可以略過不符合你 stack 的部分，但請保留 Supabase 與 Drizzle 之間的責任邊界。

什麼情況下不該用它？

如果你的後端不是 Node-based、你不打算使用 Supabase Auth 或儲存，或你想要的是完全 serverless-first、沒有 Express/Hono 層的技術棧，就不適合使用它。當你的資料層不是關聯式，或你不想處理型別化的 SQL 風格查詢時，它也會比較不合適。

如何改進 supabase-node 技能

比起「幫我做出來」，請給更具體的輸入

最好的結果來自於明確指定端點、驗證狀態、資料表名稱與回傳格式。好的 prompt 會寫成：「建立一個 GET /me 路由，從 Supabase JWT 讀取已驗證使用者，用 Drizzle 從 users 抓取 profile，並回傳 { user, profile }，同時包含驗證與錯誤處理。」

注意常見失敗模式

最常見的錯誤，是把 Supabase client 的使用和直接資料庫存取混在一起、跳過中介層，或根本沒先確認專案結構就直接假設。若第一次產出的結果太泛，請要求模型明確對應到 src/routes/、src/db/ 與 src/middleware/ 來實作。

從 schema 往外迭代

想讓 supabase-node usage 更準確，先從 schema 與驗證假設開始，再要求路由程式碼。如果你要變更功能，應先更新資料表結構、驗證規則與中介層需求，接著再重新產生對應的 route 與 query 程式碼。