supabase-node

supabase-node 技能概览

supabase-node 是做什么的

supabase-node 技能是一份构建指南，帮助你用 Supabase 和 Drizzle ORM 搭建 Node.js 后端。它最适合那些希望把 Supabase Auth 和 storage 纳入技术栈，同时仍然偏好用 Drizzle 来做类型化数据库查询，并使用 Express 或 Hono 作为 API 层的团队。

适合谁安装

如果你正在从零开始搭建后端、给现有 Node 服务补上认证，或者想在一个基于 Supabase 的应用里统一路由、中间件和数据库模式，就适合使用 supabase-node 技能。它尤其适合后端开发场景：你需要清晰区分认证、数据访问和请求校验。

它为什么不一样

核心设计思路很直接：Drizzle 负责查询，Supabase 负责认证和存储，middleware 负责校验。这样的分工能减少临时拼凑式的提示输出，也有助于避免把数据库访问模式和认证逻辑混在一起。这个技能在你需要可重复的项目结构时更有价值，而不只是生成一次性的 prompt 结果。

如何使用 supabase-node 技能

安装并放进上下文

先通过你的 skill manager 走 supabase-node install 流程，然后在处理后端任务时保持这个技能处于激活状态。发起提示时，确保模型能看到技能说明，以及与你目标相符的仓库文件，尤其是 src/routes/、src/middleware/、src/db/ 和 supabase/ 下的内容。

给技能正确的任务形态

supabase-node usage 在你的请求同时说明 API 层、认证需求和数据结构时效果最好。比如，不要只说“build posts API”，而是明确要求“添加一个受保护的 POST /posts 路由，使用 Supabase JWT auth、Drizzle inserts，并对 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。如果仓库里包含 migrations，在写新表或处理认证相关逻辑之前，先查看 supabase/migrations/。

更容易产出好结果的工作流

采用三步循环：先识别路由或功能，再确认认证和数据库路径，最后只实现与现有结构相匹配的最小改动。supabase-node guide 在你一次只提一个工作流时最强，比如“创建 session-based auth middleware”、“为 users 添加一个 Drizzle query layer”，或者“把一个 Hono route 接到 Supabase-backed 的 profile 查询上”。

supabase-node 技能常见问题

supabase-node 只适合新项目吗？

不是。它适合 greenfield 应用，但也同样适合那些需要更干净的 Supabase 集成的现有 Node 后端。主要限制是，你的项目本身最好已经接受 Express 或 Hono，加上 TypeScript 风格的后端结构。

它和通用 prompt 有什么区别？

通用 prompt 可能也能产出可运行代码，但 supabase-node 技能提供的是更可靠的架构划分：认证放哪里、查询放哪里、校验放哪里。这一点在你想要可维护的 supabase-node for Backend Development，而不是快速原型时尤其重要。

我必须把技能的每一部分都用上吗？

不需要。如果你的应用只需要认证校验和少量查询，可以只采用核心模式，不必照搬所有路由或文件夹约定。那些不符合你技术栈的部分可以跳过，但要保留 Supabase 相关职责和 Drizzle 相关职责之间的边界。

什么时候不该用它？

如果你的后端不是基于 Node，如果你不打算使用 Supabase Auth 或 storage，或者你想要完全 serverless-first、没有 Express/Hono 层的技术栈，就不适合用它。若你的数据层不是关系型，或者你不想使用类型化的 SQL 风格查询处理，它也会更不匹配。

如何改进 supabase-node 技能

给出比“build it”更强的输入

最好的结果来自对 endpoint、认证状态、表名和返回结构的明确描述。一个更强的 prompt 会这样写：“创建一个 GET /me 路由，从 Supabase JWT 读取已认证用户，用 Drizzle 从 users 表获取 profile，并返回 { user, profile }，同时包含校验和错误处理。”

留意常见失败模式

最常见的错误是把 Supabase client 的使用和直接数据库访问混在一起、跳过 middleware，或者不看项目结构就默认它长什么样。如果第一次结果显得很泛，让模型明确把实现映射到 src/routes/、src/db/ 和 src/middleware/。

从 schema 往外迭代

想获得更好的 supabase-node usage，最好先确定 schema 和认证假设，再去要路由代码。如果你要改功能，先更新表结构、校验规则和 middleware 要求；然后再重新生成对应的路由和查询代码。