Supabase Agent Skills（Supabase 官方智能体技能包）

它是什么

Supabase Agent Skills 是 Supabase 官方为 AI 编程智能体做的技能包，共两个技能。第一个叫 supabase，覆盖任何 Supabase 任务：Database、Auth、Edge Functions、Realtime、Storage、客户端库、CLI 和 MCP 服务器。第二个叫 supabase-postgres-best-practices，是一套 Postgres 规则，分成八组，从查询速度到行级安全。你的任务和某个技能的描述对得上时，你的智能体就会加载它，所以你不必按名字去调用。

1. 你用一条 npx 命令把技能包装好，只需一次
2. 你照常提出 Supabase 或 Postgres 方面的需求
3. 你的智能体加载适合这项任务的技能
4. 技能把它引向最新文档或某条 Postgres 规则
5. 你的智能体写出改动，并用一条查询来验证

适合谁

用 AI 编程智能体在 Supabase 上做开发的开发者，以及让智能体写 Postgres SQL 的任何人。postgres 技能说它适用于任何地方运行的 Postgres，所以不在 Supabase 上的数据库也适用。两个技能都是 Markdown 文件，里面没有脚本。

用在哪里

skills CLI 支持的任何智能体。README 说它适用于 18 个以上的智能体，其中点名了 Claude Code、GitHub Copilot、Cursor 和 Cline。

• Claude Code：通过 skills CLI 安装，或者作为同一个插件市场里的两个插件安装
• Cursor、GitHub Copilot、Cline 和其他智能体：用同一条 skills CLI 命令安装
• 你的项目，或者你所有的项目：默认装在项目范围，加 --global 则扩大到所有项目

如何设置

点“获取”会把一个 zip 压缩包存进你的下载文件夹，里面是 Mindket 写的安装说明，包含 Supabase 的 README 和它的智能体技能文档页给出的两种安装方式。

1. 在终端里运行安装命令。它会把两个技能加到你当前所在的项目里。如果想装给你所有的项目，就加上 --global。
2. 在那个项目里打开你的智能体。README 说技能装好后就能用。
3. 提出 Supabase 或 Postgres 方面的需求。你的智能体会挑出合适的技能。

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 也可以把它们作为插件来装。在终端里运行下面三行，不要在会话里运行。插件市场注册的名字是 supabase-agent-skills，所以每条安装命令都写成插件名、@、再加这个名字。插件里的技能名前带插件名，所以命令会变成 /supabase:supabase 这样。

claude plugin marketplace add supabase/agent-skills
claude plugin install supabase@supabase-agent-skills
claude plugin install postgres-best-practices@supabase-agent-skills

如何使用

用平常的话向你的智能体提出需求，就像 README 的例子“Optimize this Postgres query”和“Help me set up Supabase Auth with Next.js”。下表列出每个技能加载后会告诉你的智能体什么。

示例

一个列出某位客户订单的页面变慢了，你怀疑这张表的客户列上没有索引。

Help me add proper indexes to this table

你的智能体加载 Postgres 技能，找到其中一条规则：Postgres 不会自动给外键列建索引，于是建议在那一列上加一个索引。

规则文件给出的修复是在外键列上的一行 create index，你的智能体会把它改成你的表名。

新手与专家

新手：技能就是一个文件夹，里面有一个 SKILL.md 文件，你的任务和它的描述对得上时，你的智能体就会读它。装好技能包，然后照常提问就行。supabase 技能告诉你的智能体不要相信自己对 Supabase 的记忆，因为这些产品经常变化，所以它会先读更新日志。

专家：supabase 技能给你的智能体带了一份安全清单。其中四个隐患：user_metadata 绝不能用来决定授权，service_role 或 secret 密钥绝不能放进公开的客户端。在 Postgres 15 及以上版本，视图要用 security_invoker。UPDATE 策略要同时写 USING 和 WITH CHECK。

它的 CLI 说明里有两个版本门槛。supabase db query 需要 CLI v2.79.0 或更高版本，supabase db advisors 需要 v2.81.3 或更高版本。CLI 版本更旧时，你的智能体会改用 MCP 工具 execute_sql 和 get_advisors。在不使用声明式 schema 的项目里，它说要用 execute_sql 或 supabase db query 反复调整表结构，不要在本地数据库上用 apply_migration。

注意事项

这个技能包由 Supabase 制作，它说会经常更新。

• 更新：Supabase 的智能体技能文档页给出了 npx skills update，它会更新你装过的所有技能
• 令牌：supabase 技能让你的智能体为 CLI、MCP 服务器和 CI 优先使用限定权限的个人访问令牌。浏览器登录生成的是拥有整个账号权限的经典令牌
• 查文档：supabase 技能让你的智能体先用 MCP 的 search_docs 工具，再在任何文档页地址后加上 .md，以 Markdown 形式获取
• 反馈：如果你说技能给了错误的指引，你的智能体会先征求你的同意，再到 Supabase 的仓库开一个 GitHub issue
• 两条路线：Claude Code 的技能文档说，插件里的技能和技能文件夹里的副本都会加载，所以每个技能会出现两次。只选一条路线
• 作者：Supabase，MIT 许可证。Mindket 只是上架这个技能包，并不是 Supabase