安装
npx skills add supabase/server适合谁
这份技能适合正在写 Edge Functions 或 API、却不想反复手写鉴权、客户端创建和跨域处理的人。官方把它写成服务端封装:鉴权、客户端创建和上下文注入由它处理,你只写业务逻辑。它也适合已经在用 AI 编程代理的人——原文写明可以把技能装进 Claude Code、Cursor 等代理。
它不适合只做浏览器页面、从不接触服务端入口的人。请求需要进入 Edge Functions 或 API,客户端创建和鉴权才会按入站请求自动限定范围。若还没有可安装技能的代理,先确认能执行官方那一条安装命令再继续。想先只读核对也可以:让代理讲清如何用一行配置包住 fetch,不要立刻改生产函数。官方仓库见 https://github.com/supabase/server 请按该页已写出的命令操作。
3 分钟完成第一次尝试
只走官方写出的这一条技能安装路径。
前置条件:本机可以运行 npx,并且使用原文点名的一类 AI 编程代理,例如 Claude Code 或 Cursor。打开平时写 Edge Functions 或 API 的项目即可。这一步先做说明核对,不要改现网代码,也不要对外发请求。
安装位置:在项目根目录的终端执行:
npx skills add supabase/server
该命令会把技能装进当前代理。官方另外写明:在 Deno 或 Supabase Edge Functions 里可以不装包,直接从 npm:@supabase/server 导入。
触发一次低风险任务:请已安装技能的代理用文字列出「如何用 withSupabase 包一层 fetch、鉴权通过后才进入处理函数」,并写出导入语句。不要写入文件,不要调用外部接口,不要部署。
成功信号:代理能复述一次导入、一行配置后,鉴权会被校验、客户端就绪、CORS 被处理,处理函数只在鉴权成功后运行;并给出 import { withSupabase } from "npm:@supabase/server"。若它编造其他安装命令,回到上面的官方命令重试。
使用案例
案例一:给现有 Edge Function 或 API 的 fetch 入口加一层官方包装。原文主路径是用 withSupabase 包住 fetch:一次导入、一行配置之后,鉴权已校验、客户端已就绪、CORS 已处理,处理函数只在鉴权成功时运行。可先让代理标出应改的入口和应原样保留的业务代码,确认后再动手。原文没有完整函数范例时,只做到「入口被包装、鉴权失败不会进入处理函数」,不要自行补路由表或密钥方案。
案例二:在 Deno 或 Supabase Edge Functions 里直接导入,而不是先装包。原文写明该环境可以不安装,直接 import { withSupabase } from "npm:@supabase/server"。适合已在这类运行时写处理函数、只想核对导入路径的人。先确认该导入适用于当前文件的运行时;若项目不是 Deno 或 Edge Functions,原文只写到这里,不要推广到未出现的运行时。
使用边界
原文只覆盖服务端入口:客户端创建与鉴权按进入 Edge Functions 和 APIs 的入站请求自动限定范围。它不证明可用于浏览器页面、后台定时任务或未点名的托管环境。
技能安装命令仅有一条被原文写出:npx skills add supabase/server。不要把未出现的安装器写进主路径。原文点名 Claude Code、Cursor 等,这是示例集合,不能写成只支持这两个代理。
包的使用侧,原文给出 Deno / Supabase Edge Functions 的直接导入,以及用 withSupabase 包装 fetch。没有看到环境变量名、CORS 细节开关或失败重试策略时,不要补。处理函数只在鉴权成功后运行;失败时返回何种状态码,原文没有写。官方页面是 https://github.com/supabase/server 若代理建议的安装句与该页不一致,以该页为准。