用途：在任何涉及 Supabase 的任务中提供操作规范，包括数据库、Auth、Edge Functions、Realtime、Storage、Vectors、Cron、Queues 及客户端使用。
主要能力与原则：Supabase 变化频繁，实施前应先查 https://supabase.com/changelog.md 与当前文档，不能仅依赖训练数据；改动后要运行测试查询验证；同一方法失败 2-3 次应停止并换思路、查文档、看日志。
关键限制与安全：暴露 schema 中每张表都应启用 RLS，新建表可能未自动暴露给 Data API，需显式 GRANT 给 anon/authenticated。授权判断不要用 user_metadata（用户可编辑），应存于 app_metadata。删除用户不会使已有令牌失效。不要在前端暴露 service_role 或密钥。视图默认绕过 RLS，Postgres 15+ 可用 CREATE VIEW ... WITH (security_invoker = true)。UPDATE 需要 SELECT 策略，且同时需要 USING 与 WITH CHECK。auth.role() 已弃用，改用 TO authenticated/anon，并配合所有权谓词。SECURITY DEFINER 绕过 RLS，非必要不用。Storage upsert 需 INSERT + SELECT + UPDATE。安装 Supabase 包时应固定版本并提交 lockfile。
用法：CLI 命令用 --help 发现，不猜测。supabase db query 需 v2.79.0+，supabase db advisors 需 v2.81.3+；新迁移文件先用 supabase migration new <name> 创建。改 schema 用 execute_sql 或 supabase db query 迭代，不用 apply_migration 改本地 schema。提交迁移前运行 advisors，再执行 supabase db pull <descriptive-name> --local --yes，然后用 supabase migration list --local 验证。文档优先用 MCP search_docs，也可在文档 URL 后加 .md 获取。MCP 连接问题按顺序排查：curl -so /dev/null -w "%{http_code}" https://mcp.supabase.com/mcp（401 表示服务正常）、检查 .mcp.json、通过 OAuth 2.1 认证。
适用场景：需要 Supabase 数据库设计、RLS 策略、认证授权、存储、边缘函数或 CLI/MCP 操作的开发调试。限制：本资料未提供具体收费、价格与平台细节。