工具简介
它是什么:Supabase Agent Skills 是 Supabase 官方维护的 Agent Skills 集合(GitHub: supabase/agent-skills,MIT 许可),遵循开放的 Agent Skills 标准(SKILL.md + references)。它把 Supabase 与 Postgres 的实战知识打包成 agent 可按需加载的程序性知识,让编码智能体写 Supabase/Postgres 代码时有权威依据,而不是靠训练数据里的泛化猜测。技能安装后自动生效,agent 检测到相关任务即加载。
包含的技能
- supabase:覆盖 Supabase 全产品(Database、Auth、Edge Functions、Realtime、Storage、Vectors、Cron、Queues)、客户端与 SSR 集成(supabase-js、@supabase/ssr 在 Next.js/React/SvelteKit/Astro/Remix)、Auth 排障(session、JWT、cookie、getSession/getUser/getClaims、RLS)、CLI/MCP server、schema 变更与迁移、安全审计、Postgres 扩展,以及日志与错误排查。
- supabase-postgres-best-practices:Supabase 维护的 Postgres 最佳实践,31 条规则按影响排序分 8 类(查询性能、连接管理、RLS 安全、Schema 设计、并发与锁、数据访问、监控诊断、高级特性),每条含错误/正确 SQL 对照;适用于任何 Postgres,不局限于 Supabase。
接入与定价:用 npx skills add supabase/agent-skills 安装(默认项目级,--global 全局,--all 覆盖全部检测到的 agent),或作为 Claude Code 插件安装(claude plugin marketplace add supabase/agent-skills);也可搭配 Supabase Plugin 与 MCP server 一步配置。兼容 Claude Code、GitHub Copilot、Cursor、Cline 等 18+ agent,并支持 supabase.com/.well-known/agent-skills/ 发现端点。开源免费(MIT);技能提供规则指导而非执行,可与 Supabase MCP server 互补使用(MCP 负责连接执行,技能负责判断正确)。
本页内容来自 KGABC 结构化知识库。带「未验证」标记的字段表示官方资料未明确说明,不等同于「不支持」。
核心功能
- 2 个官方技能:supabase(全产品与集成开发)与 supabase-postgres-best-practices(31 条 Postgres 规则,8 类按影响排序)
- 遵循开放 Agent Skills 标准(SKILL.md + references),安装后自动按任务触发加载,不占用常驻上下文
- 覆盖 Supabase 全栈:Database/Auth/Edge Functions/Realtime/Storage/Vectors/Cron/Queues 与 supabase-js、@supabase/ssr
- Auth 排障与 Postgres 深度指导:session/JWT/RLS、索引与查询优化、连接池、迁移、pgvector/pg_cron 等
- 多安装渠道:npx skills add、Claude Code 插件市场、Supabase Plugin 与 MCP server 组合,并提供 .well-known 发现端点
适用场景
- 让编码 agent 按官方规范开发 Supabase 应用与 Supabase Auth(含 Next.js SSR 集成)
- 在写 SQL、建表、设计 schema 或迁移前加载 Postgres 最佳实践,避免全表扫描、锁表与 RLS 疏漏
- 排查 Supabase 项目错误与日志:HTTP/Postgres 错误、RLS 意外行为、权限拒绝、schema cache、超时等
- 审查与优化 Postgres 性能:索引、连接管理、慢查询、EXPLAIN 计划
- 配合 Supabase MCP server 使用:MCP 负责连接执行,技能负责判断怎样做才正确
优势
- Supabase 官方维护、MIT 开源,规则源自其内部知识库与支持经验
- supabase-postgres-best-practices 在 skills.sh 安装量超 20 万,经安全审计通过且不含可执行文件
- 遵循开放 Agent Skills 标准,兼容 18+ 主流编码智能体,安装方式灵活
- 与 Supabase MCP server 互补:既让 agent 能操作数据库,又教它正确地操作
技术能力
信息来源与可信度
| 来源类型 | 依据 | 状态 |
|---|---|---|
| GitHub - supabase/agent-skills: Agent Skills to help developers using AI agents with Supabase https://github.com/supabase/agent-skills | 官方仓库 README,确认定位、2 个技能、安装命令、18+ agent 兼容、MIT 许可与 .well-known 发现机制 | 已验证 |
| Agent Skills | Supabase Docs https://supabase.com/docs/guides/ai-tools/ai-skills | Supabase 官方文档,确认两个技能的触发场景、安装/更新命令、与 MCP server 组合及项目级/全局安装方式 | 已验证 |
| Introducing: Postgres Best Practices - Supabase Blog https://supabase.com/blog/postgres-best-practices-for-ai-agents | 官方博客,确认 31 条规则、8 大类、错误/正确 SQL 对照格式,以及与 Supabase MCP server 的互补关系 | 已验证 |
| supabase/agent-skills LICENSE (MIT) https://github.com/supabase/agent-skills/blob/main/LICENSE | LICENSE 文件与第三方目录交叉验证项目以 MIT 许可开源 | 已验证 |
| documentation https://kipt.me/guides/postgres-best-practices-skill | 第三方指南交叉验证 31 条规则、无可执行文件、MIT 许可、skills.sh 安全审计通过与各 agent 安装方式 | 已验证 |