supabase-postgres-best-practices
Claude Code 用 Supabase 技能诊断 PostgreSQL 慢查询
Claude Code 安装步骤
- 打开固定版本的 GitHub 原文，从同一提交取得 `skills/supabase-postgres-best-practices/` 完整目录。
- 把目录内容放入项目的 `.claude/skills/supabase-postgres-best-practices/`，使 `SKILL.md` 位于该目录根部。保留随目录提供的文件。
- 从项目根目录启动 Claude Code，确认命令菜单显示 `/supabase-postgres-best-practices`，再用下方样例验证。
中文摘要
用 Supabase 维护的 PostgreSQL 指南核对查询计划、组合索引和连接配置。示例聚焦开发库中的订单分页查询。
SKILL.md 中文导读
可复现示例
PostgreSQL 测试库里有 orders(id bigint, customer_id bigint, created_at timestamptz)。造 10 万条非生产数据，查询客户 42 最近的 20 笔订单。请先提供 EXPLAIN 对照方案，再建议索引。工作步骤
- 在测试库准备订单表和稳定分布的合成数据。
- 记录按 customer_id 过滤、created_at 倒序的原查询计划。
- 比较候选组合索引前后的排序节点、扫描行数和返回顺序。
验收方法
返回同一组按时间排序的 20 行，并给出优化前后的执行计划和适用条件。小表或分布偏斜时，优化器可能仍选择顺序扫描。
GitHub 原文 · 更新日期
适用环境
Claude Code。只读分析可直接提供 SQL 与执行计划，实测需独立 PostgreSQL 测试库和对应查询权限。
常见问题
Claude Code 怎么用 Supabase 技能判断该不该加组合索引？
在测试库对比同一查询加索引前后的执行计划，并确认结果顺序、扫描行数和写入开销。