用途
本技能是一份由 Supabase 维护的 Postgres 综合性能优化指南,用于指导自动化的查询优化与数据库模式设计。它把最佳实践整理为按影响程度排序的规则集,帮助在编写、审查或优化 Postgres 查询、模式设计及相关配置时获得一致的参考依据。
主要能力
规则按优先级分为 8 个类别,每个类别带有统一前缀,便于检索与引用:
| 优先级 | 类别 | 影响 | 前缀 |
|---|---|---|---|
| 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 示例、带有解释的正确 SQL 示例、可选的 EXPLAIN 输出或指标、补充背景与参考,以及在适用时给出的 Supabase 专属说明。
使用方式
在以下情形参考这些指南:编写 SQL 查询或设计模式;实现索引或进行查询优化;审查数据库性能问题;配置连接池或扩展;针对 Postgres 特有功能进行优化;处理行级安全(RLS)。
可按需阅读单条规则文件以获取详细说明与 SQL 示例,例如:
- rules/query-missing-indexes.md
- rules/schema-partial-indexes.md
- rules/_sections.md
如需包含全部规则展开的完整指南,请参阅 AGENTS.md。
适用场景
适用于与 Postgres 查询编写、模式设计、索引与查询优化、连接池与扩展配置、性能问题排查、Postgres 特有功能优化以及行级安全(RLS)相关的任务。
限制
仅在任务明确符合上述范围时使用本技能。不要将输出视为针对具体环境的验证、测试或专家评审的替代品。若缺少必要输入、权限、安全边界或成功标准,应停止并请求澄清。