SupabasePostgres最佳实践Skill supabase-postgres-best-practices

name: supabase-postgres-best-practices description: Supabase 提供的 Postgres 性能优化和最佳实践。在编写、审查或优化 Postgres 查询、模式设计或数据库配置时使用此技能。 license: MIT metadata: author: supabase version: “1.0.0”

Supabase Postgres 最佳实践

由 Supabase 维护的全面 Postgres 性能优化指南。包含跨8个类别的规则，按影响优先级排序，以指导自动化查询优化和模式设计。

何时应用

在以下情况下参考这些指南：

• 编写 SQL 查询或设计模式时
• 实现索引或优化查询时
• 审查数据库性能问题时
• 配置连接池或扩展时
• 优化 Postgres 特定功能时
• 使用行级安全性 (RLS) 时

按优先级排序的规则类别

优先级	类别	影响	前缀
1	查询性能	关键	query-
2	连接管理	关键	conn-
3	安全与 RLS	关键	security-
4	模式设计	高	schema-
5	并发与锁定	中-高	lock-
6	数据访问模式	中	data-
7	监控与诊断	低-中	monitor-
8	高级功能	低	advanced-

如何使用

阅读单个规则文件以获取详细解释和 SQL 示例：

rules/query-missing-indexes.md
rules/schema-partial-indexes.md
rules/_sections.md

每个规则文件包含：

• 简要解释为何重要
• 不正确的 SQL 示例及解释
• 正确的 SQL 示例及解释
• 可选的 EXPLAIN 输出或指标
• 额外上下文和参考文献
• Supabase 特定说明（如适用）

完整编译文档

如需查看所有规则扩展的完整指南： AGENTS.md