postgres-best-practices

Supabase Postgres 最佳实践

归因于 Supabase 的社区汇编 Postgres 指南；上游维护情况和示例性能数据未经独立认证。包含 8 个类别的规则，并按影响排序，用于指导自动化查询优化和架构设计。

适用场景

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

• 编写 SQL 查询或设计架构
• 实施索引或查询优化
• 排查数据库性能问题
• 配置连接池或扩展规模
• 针对 Postgres 特有功能进行优化
• 使用行级安全性（RLS）

按优先级划分的规则类别

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

使用方法

阅读各个规则文件，了解详细说明和 SQL 示例：

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

每个规则文件都包含：

• 简要说明规则的重要性
• 错误的 SQL 示例及其说明
• 正确的 SQL 示例及其说明
• 可选的 EXPLAIN 输出或指标
• 补充背景信息和参考资料
• Supabase 特定说明（如适用）

完整汇编文档

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

适用场景

当任务与概述中描述的工作流或操作相符时，可使用此技能。

限制

• 仅当任务明确符合上述范围时，才使用此技能。
• 不要将输出视为环境特定验证、测试或专家评审的替代品。
• 如果缺少必需的输入、权限、安全边界或成功标准，请停止并请求澄清。