supabase/agent-skills

 # Supabase Agent Skills Agent Skills 旨在帮助开发者在 Supabase 中使用 AI agent。Agent Skills 是包含指令、脚本和资源的文件夹，agent 可以发现并使用它们，从而更准确、高效地执行任务。兼容 18+ 种 AI agent，包括 Claude Code、GitHub Copilot、Cursor、Cline 等。 本仓库中的技能遵循 [Agent Skills](https://agentskills.io/) 格式。 ## 安装 请参阅 [Supabase AI Skills 文档](https://supabase.com/docs/guides/getting-started/ai-skills) 获取详细的安装说明。 ### 安装所有 skills ``` npx skills add supabase/agent-skills ``` ### 安装特定 skill ``` npx skills add supabase/agent-skills --skill supabase npx skills add supabase/agent-skills --skill supabase-postgres-best-practices ``` ### Claude Code 插件 您也可以将这些 skills 作为 Claude Code 插件安装： ``` # 1. 安装 supabase/agent-skill marketplace claude plugin marketplace add supabase/agent-skills # 2. 安装你想要的 plugin claude plugin install supabase@supabase-agent-skills claude plugin install postgres-best-practices@supabase-agent-skills ``` ## 可用 Skills

supabase

涵盖所有 Supabase 产品和集成的全面 Supabase 开发 skill。 **适用场景：** - 使用任何 Supabase 产品（Database、Auth、Edge Functions、Realtime、Storage、Vectors、Cron、Queues） - 在 Next.js、React、SvelteKit、Astro、Remix 中使用客户端库和 SSR 集成（supabase-js、@supabase/ssr） - 排查身份验证问题（登录、登出、会话、JWT、cookies、getSession、getUser、getClaims、RLS） - 使用 Supabase CLI 或 MCP server - 处理 schema 更改、迁移、安全审计或 Postgres 扩展（pg_graphql、pg_cron、pg_vector）

supabase-postgres-best-practices

来自 Supabase 的 Postgres 性能优化指南。包含 8 个类别的参考资料，并按影响程度排列优先级。 **适用场景：** - 编写 SQL 查询或设计 schema - 实施 index 或进行查询优化 - 审查数据库性能问题 - 配置连接池或扩展 - 使用行级安全（RLS） **涵盖的类别：** - 查询性能（关键） - 连接管理（关键） - Schema 设计（高） - 并发与锁定（中高） - 安全与 RLS（关键） - 数据访问模式（中） - 监控与诊断（中低） - 高级功能（低）

## 用法 skills 安装后会自动可用。当检测到相关任务时，agent 会自动调用它们。 **示例：** ``` Optimize this Postgres query ``` ``` Review my schema for performance issues ``` ``` Help me set up Supabase Auth with Next.js ``` ``` Help me add proper indexes to this table ``` ## Skill 结构 每个 skill 都遵循 [Agent Skills 开放标准](https://agentskills.io/)： - `SKILL.md` - 必需的 skill 清单，包含 frontmatter（名称、描述、元数据） - `references/` - （可选）用于详细说明的参考文档 ## `.well-known` 发现机制 每次发布都会随 skill tarballs 一起上传一个 `dist/index.json`。此索引符合 [agent-skills `.well-known` URI 规范](https://github.com/agentskills/agentskills/pull/254)（schema v0.2.0），并由 `supabase.com` 使用，以在 `https://supabase.com/.well-known/agent-skills/` 提供 skills 服务。 发布产物由 `scripts/build-release.ts` 构建，并在每次 semver 发布时由 [Release Please](https://github.com/googleapis/release-please) 触发。 ### 迁移至官方 GitHub Action [`jonathanhefner/agentskills-build-for-well-known`](https://github.com/jonathanhefner/agentskills-build-for-well-known) 计划移交给 `agentskills` 组织并发布到 GitHub Marketplace。待其实现后，`scripts/build-release.ts` 以及 `release-please.yml` 中的 `pnpm build:release` 步骤就可以直接替换为该 Action： ``` - name: Build release artifacts uses: agentskills/build-for-well-known@v1 # replaces pnpm build:release with: skills-dir: skills output-dir: dist ``` 其余部分——Release Please 触发器、上传步骤、supabase-plugin dispatch——保持完全不变。该脚本与该 Action 产生的输出完全相同，因此可以直接无缝替换。

标签：AI编程助手, SOC Prime, Supabase, 开发工具, 开发者文档, 提示词工程, 测试用例, 策略决策点, 自动化攻击