supabase-agent-skills

supabase-agent-skills

当任务涉及使用开源的 supabase/agent-skills 包为 AI Agent 启用 Supabase 工作流时，请使用此技能。

使用场景

• 为 Claude/Codex/Copilot/Cursor 风格的 Agent 安装 Supabase 技能包
• 仅选择特定的 Supabase 技能，而不是批量安装
• 在依赖生成的代码之前，验证技能是否已成功安装
• 技能加载不可用时，转而执行直接的 SQL/CLI 检查

说明

步骤 1：验证前置条件

• 确认 Node.js 和 npm/npx 均可用。
• 确认项目确实使用 Supabase/Postgres，然后再安装额外技能。

node -v
npm -v

步骤 2：安装技能包

选择以下路径之一：

# Install all Supabase skills
npx skills add supabase/agent-skills

# Install specific skill only
npx skills add supabase/agent-skills --skill supabase
npx skills add supabase/agent-skills --skill supabase-postgres-best-practices

步骤 3：可选的 Claude 插件路径

如果使用 Claude 插件工作流：

claude plugin marketplace add supabase/agent-skills
claude plugin install supabase@supabase-agent-skills

步骤 4：验证并进行冒烟测试

• 确认已安装的技能列表中包含 Supabase 条目。
• 运行一项范围明确的任务（架构内省或查询审查），并检查输出质量。
• 如果结果不理想，则回退到直接运行命令并检查 SQL。

步骤 5：回退策略

当 Agent 技能加载不可用时：

• 使用直接的 Supabase CLI 和 SQL 工作流。
• 明确执行迁移和审查步骤；不要依赖隐藏的 Agent 假设。

安全防护

• 未经明确确认，不要运行具有破坏性的 SQL/迁移。
• 优先进行只读验证（SELECT、架构内省、可用时使用 dry-run）。
• 将凭据保存在环境变量或密钥管理器中；切勿将令牌硬编码到仓库文件中。

依据

• 直接检索页面：https://github.com/supabase/agent-skills
• 直接检索页面：https://supabase.com/docs/guides/getting-started/ai-skills