Supabase 代理技能

用于帮助开发者使用 AI 代理与 Supabase 集成的代理技能。代理技能是一系列指令、脚本和资源的文件夹，代理可以发现并使用它们来更准确、高效地完成任务。兼容 18 种以上的 AI 代理，包括 Claude Code、GitHub Copilot、Cursor、Cline 等众多工具。

此仓库中的技能遵循 Agent Skills 格式。

安装

请参阅 Supabase AI 技能文档 获取详细的安装说明。

安装所有技能

npx skills add supabase/agent-skills

安装特定技能

npx skills add supabase/agent-skills --skill supabase
npx skills add supabase/agent-skills --skill supabase-postgres-best-practices

Claude Code 插件

您也可以将这些技能作为 Claude Code 插件进行安装：

# 1. 安装 supabase/agent-skill 市场
claude plugin marketplace add supabase/agent-skills

# 2. 安装您需要的插件
claude plugin install supabase@supabase-agent-skills
claude plugin install postgres-best-practices@supabase-agent-skills

可用技能

supabase

全面的 Supabase 开发技能，涵盖所有 Supabase 产品及集成。

适用场景：

• 使用任何 Supabase 产品（数据库、认证、边缘函数、实时、存储、向量、定时任务、队列）
• 在 Next.js、React、SvelteKit、Astro、Remix 中使用客户端库和 SSR 集成（supabase-js、@supabase/ssr）
• 排查认证相关问题（登录、登出、会话、JWT、Cookie、getSession、getUser、getClaims、RLS）
• 使用 Supabase CLI 或 MCP 服务器
• 处理模式变更、迁移、安全审计或 Postgres 扩展（pg_graphql、pg_cron、pg_vector）

supabase-postgres-best-practices

来自 Supabase 的 Postgres 性能优化指南。包含八个类别的参考内容，按影响程度排序。

适用场景：

• 编写 SQL 查询或设计数据库模式
• 实施索引或查询优化
• 审查数据库性能问题
• 配置连接池或进行扩展
• 使用行级安全（RLS）

涵盖的类别：

• 查询性能（关键）
• 连接管理（关键）
• 模式设计（高）
• 并发与锁（中高）
• 安全与 RLS（关键）
• 数据访问模式（中）
• 监控与诊断（低到中）
• 高级特性（低）

使用方法

技能在安装完成后会自动可用。当检测到相关任务时，代理会自动调用这些技能。

示例：

优化这个 Postgres 查询

检查我的数据库模式是否存在性能问题

帮我用 Next.js 设置 Supabase 认证

帮我为这张表添加合适的索引

技能结构

每个技能都遵循 Agent Skills 开放标准：

• SKILL.md - 必需的技能清单文件，包含前言信息（名称、描述、元数据）
• references/ - （可选）详细文档的参考文件夹

Supabase Agent Skills 快速上手指南

Supabase Agent Skills 是一套专为 AI 编程助手（如 Claude Code、GitHub Copilot、Cursor、Cline 等）设计的技能包，旨在帮助开发者更高效、准确地使用 Supabase 进行开发。

环境准备

• 系统要求：支持 macOS、Linux 或 Windows（需安装 Node.js 环境）。
• 前置依赖：
  • 已安装 Node.js (推荐 LTS 版本)。
  • 已安装并配置好任意兼容的 AI 编程助手（如 Cursor、Claude Code 等）。
  • 确保终端可以访问 npm registry。

注意：目前官方未提供特定的中国镜像源配置，如遇网络安装缓慢，建议在终端临时配置淘宝镜像：

npm config set registry https://registry.npmmirror.com

安装步骤

你可以选择安装所有技能，或仅安装特定的技能包。请在项目根目录或全局环境下运行以下命令。

1. 安装所有技能

一次性安装包含所有 Supabase 产品和最佳实践的技能包：

npx skills add supabase/agent-skills

2. 安装特定技能

如果你只需要某项具体功能，可以单独安装：

安装综合开发技能（涵盖数据库、Auth、Edge Functions 等）：

npx skills add supabase/agent-skills --skill supabase

安装 Postgres 性能优化最佳实践：

npx skills add supabase/agent-skills --skill supabase-postgres-best-practices

3. Claude Code 用户专属安装

如果你使用的是 Claude Code，可以通过插件方式安装：

# 第一步：添加 marketplace
claude plugin marketplace add supabase/agent-skills

# 第二步：安装具体插件（任选其一或全部）
claude plugin install supabase@supabase-agent-skills
claude plugin install postgres-best-practices@supabase-agent-skills

基本使用

技能安装完成后会自动生效，无需额外配置。当你在对话中提及与 Supabase 或 Postgres 相关的任务时，AI 助手会自动调用相应的技能知识。

使用示例：

直接在对话框中输入以下自然语言指令：

• 查询优化

  Optimize this Postgres query
  

• 架构审查

  Review my schema for performance issues
  

• Auth 集成

  Help me set up Supabase Auth with Next.js
  

• 索引建议

  Help me add proper indexes to this table
  

AI 将基于内置的 supabase 综合技能或 supabase-postgres-best-practices 最佳实践，提供更精准的代码建议和解决方案。