---

name: postgres-best-practices description: "来自 Supabase 的 Postgres 性能优化和最佳实践。在编写、审查或优化 Postgres 查询、模式设计或数据库配置时使用此技能。" risk: safe source: community date_added: "2026-02-27"

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

使用时机

此技能适用于执行概述中描述的工作流或操作。

限制

• 仅在任务明确匹配上述范围时使用此技能。
• 不要将输出视为环境特定验证、测试或专家审查的替代品。
• 如果缺少所需输入、权限、安全边界或成功标准，请停下来寻求澄清。