[ PROMPT_NODE_25082 ]
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`