Supabase Agent Skills：把权限、迁移和索引建议变得可审阅

Supabase Agent Skills：把权限、迁移和索引建议变得可审阅

一句话看懂

数据库建议不能只看“SQL 能不能运行”，还要看谁能读写、怎么保留迁移记录、索引是否真有帮助。这套资料给编码助手提供 Supabase 开发方法和 Postgres 实践参考，帮助它输出有检查步骤的建议。它不是数据库服务，也不会自行连接或修改你的项目。

它能帮你做什么

• 区分表访问权限和行级权限，整理按用户角色验证的步骤。
• 根据项目采用的结构管理方式，选择合适的迁移路线。
• 对照过滤列和关联列的索引示例，提出可验证的查询优化建议。

检查谁能看到哪些行

输入：脱敏后的表结构、现有策略，以及两个用户应该看到的数据范围。

1. 让助手阅读 supabase 正文，分别检查 GRANT 和 RLS。前者决定能否访问表，后者控制能访问哪些行。
2. 对更新策略核对目标角色、USING 和 WITH CHECK 的实际效果，不把“已登录”当作“可以访问所有记录”。
3. 要求列出用户甲、用户乙和未登录状态的测试安排。

输出：待审阅的策略建议和按角色划分的验证清单。

成功标志：清单包含允许与拒绝两类结果，实际测试在开发库进行，而不是直接扩大生产权限。

先识别迁移方式

输入：不含密钥的项目目录结构与 config.toml 相关配置。

1. 检查是否存在 supabase/schemas 或 schema_paths 配置。
2. 让助手说明应维护声明式结构文件，还是采用现有命令式迁移流程。
3. 输出迁移生成、差异审查和记录检查步骤，交由工程师确认后再实施。

输出：符合现有项目方式的修改计划。

成功标志：不混用两条流程，不凭空编造迁移文件名，并保留可审查的变更历史。

给慢查询提出索引假设

输入：例如按 customer_id 查询 orders 的脱敏 SQL、表结构、已有索引和查询计划。

1. 阅读 supabase-postgres-best-practices 中的 query-missing-indexes 参考。
2. 让助手解释 orders_customer_id_idx 示例与自己的过滤列、关联列是否对应。
3. 在开发环境审查索引代价，再比较改动前后的查询计划和测量结果。

输出：索引建议及验证方法，而不是固定倍数的提速承诺。

成功标志：建议能解释为何适用；实际计划和数据支持结论。小表仍可能合理地选择顺序扫描，不能仅凭未出现 Index Scan 就认定失败。

下载后怎么用

先解压 source-packages 中的源码 ZIP。skills 中有 supabase 和 supabase-postgres-best-practices 两个文件夹。无需命令即可阅读各自 SKILL.md；按自己的助手支持的本地技能导入方式加载完整文件夹，保留 references，不覆盖同名自定义技能。

首次可以把脱敏材料和下面的请求一起交给助手：

阅读本地 Supabase 和 Postgres 技能资料。
只审查我给出的表结构、权限策略和查询，不连接数据库、不执行 SQL。
先区分表访问权限与行级权限，再列出建议、理由和开发库验证步骤。
不要输出密钥，不要扩大生产权限。

成功标志：助手给出与输入字段对应的建议、假设和验证清单，而不是声称已修改数据库。实际接入工具前，另行核对当前官方文档、CLI 版本、项目身份与权限；原始 README 的在线安装方式可能取得更新内容，不等于本包固定版本。

使用前要准备什么

• 一个支持读取技能文件的编码助手，以及脱敏的数据库问题材料。
• 要实际验证时，使用有备份的开发数据库和最小必要权限。不要向助手公开 service_role 或其他密钥；API 是程序访问服务的接口，不代表可以忽略权限隔离。
• 资料本身采用 MIT 许可，不要求购买专用订阅。可选 Supabase 托管数据库的付费方案和超额服务按平台规则计费；选择 Claude Code 等助手时，模型账号或订阅另行准备。包内不含托管额度。

适不适合你

• 适合使用 Supabase 或 Postgres，希望让助手的数据库建议更容易检查的开发者。
• 下载前先看：官方方法仍需要结合数据库版本、策略组合、项目结构和当前文档判断，不能替代独立安全审查。
• 下载前先看：规则中的 SQL 和性能数值是解释示例，不是你的项目测试结果。本资料不是一键部署包，也不保证生成代码正确。

资源包里有什么

• 固定版本原始源码 ZIP，含两项 Skill 正文、数据库参考文件及项目原有说明。
• 原有 README 和 LICENSE、中文使用说明、内容档案、版本记录和文件校验清单。
• 一张资源讲解卡及其 HTML、《资源使用介绍》PDF。没有数据库数据、登录凭据或 Supabase 服务运行时。

资源版本说明

本资源整理自 Supabase Agent Skills 项目方公开内容，对应版本在 metadata.json 中记录。包内 supabase 正文版本为 0.1.2，Postgres 实践正文版本为 1.1.1。本次整理只阅读文档和校验归档，未执行数据库连接、SQL、迁移或权限测试。