[ PROMPT_NODE_23494 ]
supabase-postgres-best-practices
[ SKILL_DOCUMENTATION ]
# 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`