Agent Skills
返回列表
💻

Supabase

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/supabase-agent-skills-supabase。

技能介绍

你在解决什么问题

Supabase 的 CLI 签名、config.toml、Data API 与 RLS 行为会随版本变动,单靠模型训练记忆实现功能很容易踩到静默失败:表已建好却 REST 不可见、UPDATE 因缺 SELECT 策略返回 0 行、视图默认绕过 RLS、或 SECURITY DEFINER 函数在 public 下对匿名角色可执行。本技能把官方 changelog、文档检索路径和项目内常见的安全陷阱收拢成可执行流程,而不是泛泛介绍产品能力。

技能如何工作

实现前先拉取 changelog 扫 breaking 标签,再用 MCP search_docs、文档页追加 .md 或定向搜索定位当前版本说明。涉及 auth、RLS、视图、Storage 或用户数据时,按技能内置安全清单逐项核对(例如禁止用 user_metadata 做授权、TO authenticated 须配合行级所有权条件、Storage upsert 需 INSERT+SELECT+UPDATE)。

Schema 变更先区分 declarative(supabase/schemas/)与 imperative 迁移:迭代期用 execute_sql 或 supabase db query 直跑 SQL,避免误用 apply_migration 把半成品写进历史;提交前跑 db advisors、过安全清单,再 supabase db pull --local --yes 生成迁移。CLI 与 MCP 有版本门槛(如 db query 需 v2.79.0+),技能会指向降级方案(psql、MCP get_advisors)。排错时必须先查官方 Monitoring and Debugging 文档,再改 RLS 或 API 配置;Data API 不可访问时同步检查表是否对 anon/authenticated GRANT 且已开 RLS。

适用边界

技能不替代你项目里的业务授权模型设计;RLS 策略仍需按真实访问模型手写,而非套用单一 auth.uid() 模板。对未在清单中覆盖的安全议题,应继续查阅 product security 索引。若用户反馈技能指引有误,需按技能引用的 skill-feedback.md 处理。

使用场景

  • 新项目把 SQL 建的表接到前端 REST,却发现 anon 角色请求 404 或空权限,需要核对 Data API 与 GRANT
  • 为已暴露 schema 补 RLS 与策略时,UPDATE 无报错却不改行,需要对照 SELECT/USING/WITH CHECK 要求排查
  • 在本地反复改表结构,准备生成干净迁移文件,需区分 declarative 与 imperative 并避免 apply_migration 污染历史
  • 集成 Supabase MCP 后工具不可见或连不上,需要按可达性、.mcp.json 与 OAuth 顺序排查

适合人员

  • 全栈工程师在 Next.js 等前端使用 publishable key,需避免把 service_role 打进 NEXT_PUBLIC_ 环境变量
  • 负责多租户 SaaS 的数据库开发,要用 app_metadata 与所有权谓词设计 RLS,而不是 user_metadata 声明
  • 用 Supabase CLI 维护迁移的团队成员,需在 advisors 通过后再 db pull 并核对 SECURITY DEFINER 函数暴露面
  • 在 Cursor 等代理里接 MCP 的维护者,要在 db query 版本不足时改用 execute_sql 或 psql