SuperAPI AI 工具集

supabase

通用与其它

查看项目

更新于 10-16 01:49

技能介绍

用途:该技能面向所有涉及 Supabase 的任务,触发范围包括 Database、Auth、Edge Functions、Realtime、Storage、Vectors、Cron、Queues 等产品及客户端相关操作。

主要能力与原则:Supabase 变化频繁,不应依赖训练数据,需先获取 https://supabase.com/changelog.md 扫描破坏性变更,再按文档方式查阅相关主题;实现修复后要运行测试查询验证;同一方法失败 2-3 次应停止并换思路、查文档、看日志。

数据 API 与 RLS:新建表可能不会自动暴露给 Data(REST)API,需显式 GRANT 给 anon/authenticated;这与 RLS 不同,RLS 控制行可见性。暴露 schema 中的每张表都应启用 RLS,并按实际访问模型编写策略。

安全要点:不要在 JWT 授权中使用 user_metadata;删除用户不会使已有令牌失效;不要在前端暴露 service_role 或 secret key;Management API、CLI、MCP 应使用限定范围的 personal access token;视图默认绕过 RLS,Postgres 15+ 用 CREATE VIEW ... WITH (security_invoker = true);UPDATE 需要 SELECT 策略;auth.role() 已弃用,改用 TO 子句;TO authenticated 需配合 USING 中的归属判断;UPDATE 策略需同时有 USING 和 WITH CHECK;SECURITY DEFINER 会绕过 RLS,应优先 SECURITY INVOKER;Storage upsert 需要 INSERT + SELECT + UPDATE;安装 Supabase 包时应固定版本并提交 lockfile。

CLI 与 MCP:用 --help 发现命令,不要猜测。supabase db query 需 CLI v2.79.0+,supabase db advisors 需 v2.81.3+。CI 中设置 SUPABASE_ACCESS_TOKEN 为限定范围令牌。MCP 连接问题按顺序排查:检查服务器可达性(401 属正常)、检查 .mcp.json、完成 OAuth 2.1 认证、检查令牌权限。

Schema 变更:先判断项目使用声明式 schema(supabase/schemas/ 或 config.toml 的 schema_paths)还是命令式迁移。命令式下用 execute_sql 或 supabase db query 迭代,不要用 apply_migration 改本地 schema;提交时先跑 advisors,再 supabase db pull <name> --local --yes,最后 supabase migration list --local 验证。

调试:遇到 REST、Postgres、PostgREST、Auth、Realtime、Edge Functions、Storage 等错误时,应先查阅 Supabase 监控与调试文档再诊断。

限制:资料未提供具体收费、价格、平台支持范围或效果数据。