supabase-node

supabase-node スキルの概要

supabase-node は何に使うのか

supabase-node スキルは、Supabase と Drizzle ORM を使って Node.js バックエンドを作るためのビルドガイドです。Supabase Auth とストレージをスタックに入れつつ、型付きのデータベースクエリには Drizzle を使い、API レイヤーは Express か Hono で組みたいチームに最適です。

どんな人がインストールすべきか

新しいバックエンドを立ち上げる場合、既存の Node サービスに認証を追加する場合、あるいは Supabase ベースのアプリ全体で route、middleware、database の作法を揃えたい場合に supabase-node スキルを使ってください。とくに、auth、data access、request validation を明確に分離したいバックエンド開発では効果的です。

何が違うのか

設計の要点はシンプルです。クエリは Drizzle、認証とストレージは Supabase、バリデーションは middleware が担当します。この役割分担によって、場当たり的な prompt 出力を減らし、DB アクセスの書き方と auth ロジックが混ざるのを防ぎやすくなります。単発の prompt ではなく、再現性のあるプロジェクト構成が必要なときに価値が高いスキルです。

supabase-node スキルの使い方

インストールして文脈に置く

スキルマネージャーから supabase-node install の流れで導入し、バックエンド作業のあいだはスキルを有効にしておきます。prompt を出すときは、モデルがスキルの指示と、目的に合う repo ファイルを見られる状態にしてください。特に src/routes/、src/middleware/、src/db/、supabase/ 配下は重要です。

タスクの形を正しく渡す

supabase-node usage が最も力を発揮するのは、依頼の中で API レイヤー、認証要件、データ形状を明示したときです。たとえば「posts API を作って」ではなく、「Supabase JWT 認証を使った保護付きの POST /posts route を追加し、Drizzle の insert と title/body フィールドの request validation も入れて」と伝えると、スキルが適切なファイルと境界を選びやすくなります。

まず読むべきファイル

最初に 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 を確認します。repo に migration があるなら、新しい table や auth 関連のロジックを書く前に supabase/migrations/ も見てください。

より良い出力を得るワークフロー

3 段階のループで進めると精度が上がります。まず route か feature を特定し、次に auth と DB の経路を確認し、最後に既存構成に合う最小限の変更だけを実装します。supabase-node guide は、一度に 1 つのワークフローだけを頼むと強いです。たとえば「session ベースの auth middleware を作る」「users 向けの Drizzle query layer を追加する」「Supabase-backed の profile 取得に Hono route をつなぐ」といった依頼が向いています。

supabase-node スキル FAQ

supabase-node は新規プロジェクト専用ですか？

いいえ。greenfield アプリに向いているのはもちろんですが、Supabase の統合をより整えたい既存の Node バックエンドにも適しています。主な前提は、プロジェクトがすでに Express か Hono と TypeScript 風のバックエンド構成に馴染んでいることです。

一般的な prompt と何が違うのですか？

一般的な prompt でも動くコードは生成できますが、supabase-node スキルはより信頼しやすいアーキテクチャを与えます。auth をどこに置くか、query をどこに置くか、validation をどこに置くかが明確になるためです。短期的な試作ではなく、保守しやすい supabase-node for Backend Development を目指すときに効きます。

スキルのすべてを使う必要はありますか？

いいえ。アプリが必要としているのが auth の検証と少数の query だけなら、すべての route や folder 規約を採用しなくても、コアのパターンだけを使えます。stack に合わない部分は省いて構いませんが、Supabase の責務と Drizzle の責務の境界は保ってください。

どんなときは使わないほうがいいですか？

バックエンドが Node ベースでない場合、Supabase Auth や storage を使う予定がない場合、あるいは Express/Hono レイヤーを置かない serverless-first の構成を目指す場合は使わないでください。また、data layer が relational でない場合や、型付きの SQL 風 query 処理を望まない場合にも相性は弱めです。

supabase-node スキルを改善するには

「作って」より具体的な入力を渡す

最良の結果を得るには、endpoint、auth 状態、table 名、response 形状まで指定します。強い prompt の例は次のようなものです。「Supabase JWT から認証済みユーザーを読み取り、Drizzle で users から profile を取得し、validation と error handling を含めて { user, profile } を返す GET /me route を作ってください。」

ありがちな失敗を避ける

よくあるミスは、Supabase client の使い方と direct DB access を混ぜること、middleware を飛ばすこと、あるいは project structure を確認せずに前提で進めることです。最初の結果が汎用的に見えるなら、src/routes/、src/db/、src/middleware/ に implementation を明示的に対応づけるよう依頼してください。

schema から外側へ順に詰める

supabase-node usage を良くするには、route code を頼む前に schema と auth の前提を固めるのが有効です。feature 変更が必要なら、まず table 形状、validation rules、middleware 要件を更新し、そのあとで route と query code を再生成して整合させてください。