supabase

supabase skill 概览

supabase skill 是用来做什么的

supabase skill 帮你以 local-first 的工作流处理基于 Supabase 的应用：数据库变更、认证、存储、Edge Functions，以及通过 migrations 部署，而不是手动改生产环境。它最适合需要一份实用的 supabase 后端开发指南、而不是一段泛泛而谈 PostgreSQL 提示词的读者。

谁应该安装它

如果你正在构建或维护一个已经使用 Supabase 的项目，或者你需要把一个粗糙的产品想法整理成结构化的本地开发流程，那么就应该用这个 supabase skill。它在你关心 schema 变更、RLS、环境配置，以及如何让本地状态和远端状态保持一致时，尤其有用。

它有什么不同

它的核心价值在于流程，而不是理论：supabase 安装指引、CLI 配置、关联远程项目、以及严格的 migration 流程。当你希望减少临时性的数据库手改、增加可重复的变更时，它会比自由发挥式 prompting 更合适。

如何使用 supabase skill

安装并打开正确的文件

先把这个 skill 安装到你的 skills 目录里，然后从 SKILL.md 和项目的 supabase/ 目录开始看。在这里给出的 repo 里，没有辅助脚本或额外的参考目录，所以第一轮阅读应该聚焦核心说明，而不是去找隐藏的工具链。

给 skill 正确的输入

想要更好的结果，prompt 里要明确写出你要完成的具体 Supabase 任务、项目类型，以及任何约束。好的输入例如：“给一个 SaaS 应用加一个带 RLS 的 profiles 表”、“创建一个用于 webhook 验证的 Edge Function”，或者“排查为什么本地 auth 正常但远程登录失败”。像“修一下 Supabase”这种模糊输入，通常只会得到泛泛的输出。

按照 local-first 工作流推进

用这个 skill 先在本地规划变更：初始化 Supabase，把 schema 修改写成 migrations，用 CLI 测试，确认本地结果正确后再 link 和 push。如果你是在现有项目里工作，可以先让 skill 推断你是否应该在改动之前检查 supabase/config.toml、supabase/migrations/ 和 supabase/seed.sql。

先读这些来源

先看 SKILL.md，如果需要命令级细节，再去看里面链接的 Supabase CLI 文档。对于你自己的项目，优先检查 supabase/config.toml、已有 migrations、seed 数据，以及 skill 路径里提到的任何环境文件。通常正是这些文件决定了最终结果到底能不能直接用。

supabase skill 常见问题

supabase 只适合后端开发吗？

基本上是。supabase skill 最擅长的是数据库设计、RLS、认证流程、存储策略和 Edge Functions 这类后端开发任务。它不能完全替代前端架构层面的帮助。

使用前需要先懂 Supabase 吗？

不需要，但你得能清楚描述自己想要的结果。只要你能说清楚需要什么表、什么 policy、什么 function，或者什么 auth 流程，这个 skill 就很适合入门使用。如果你连数据模型或访问规则都定义不出来，就要预期在 prompt 细化上多花一些时间。

这和普通 prompt 有什么区别？

普通 prompt 往往只是把 Supabase 功能分开解释。这个 supabase skill 的目标是指导实施决策：本地怎么搭、怎么保持 migrations 干净、怎么避免直接改生产环境。也就是说，当你要的是一个能跑的改动，而不只是一个解释时，它会更好用。

什么时候不该用这个 skill？

如果你只是问一个一次性的概念问题，而且没有项目上下文，或者你的技术栈根本不是基于 Supabase 的，就不该用它。如果你想做的是偏 UI 的前端工作，而且完全不涉及数据库、认证或 function 变更，它也不适合。

如何改进 supabase skill

提供准确的 Supabase 作用范围

最有效的改进方式，是把具体范围说清楚：database schema、RLS policies、auth settings、storage buckets、realtime subscriptions，或者 Edge Functions。任务范围越精确，skill 需要猜测的部分就越少，输出也会越有用。

在请求变更前说明当前状态

如果表、policy 或 function 已经存在，就把当前 SQL、migration 名称或报错信息一起带上。这一点很重要，因为 supabase 的使用经常卡在本地状态和远程状态的边界上，而 skill 只有知道哪些内容已经部署，才能真正帮上忙。

要 implementation，不只是建议

直接请求具体产物：migration SQL、policy definitions、CLI commands，或者一步一步的 supabase 安装与部署流程。如果第一次回答太宽泛，就继续收窄需求，比如要求“把这个改写成 migration”或者“只补上缺失的 RLS policy”。

留意常见失败模式

常见问题通常是 prompt 太模糊、缺少项目上下文，以及把本地和生产环境的改动混在一次请求里。想让 supabase skill 给出稳定结果，就要把环境信息说清楚，不要默认 policy 已经存在，并明确目标是全新项目还是已有的 Supabase 应用。