用途:这是一份由 Supabase 维护的 Postgres 性能优化指南技能,适用于任何环境运行的 Postgres。在编写或修改任何位于 Postgres 中的内容之前应先加载本技能,用于指导自动化查询优化与模式设计。
主要能力:包含 8 个类别的规则,按影响优先级排列:查询性能(CRITICAL,前缀 query-)、连接管理(CRITICAL,conn-)、安全与 RLS(CRITICAL,security-)、模式设计(HIGH,schema-)、并发与锁(MEDIUM-HIGH,lock-)、数据访问模式(MEDIUM,data-)、监控与诊断(LOW-MEDIUM,monitor-)、高级特性(LOW,advanced-)。
适用场景:编写 SQL 查询或设计模式;实现索引或查询优化;排查数据库性能问题;配置连接池或扩展;优化 Postgres 特有功能;使用行级安全(RLS)。资料提供决策树:慢查询对应 query-missing-indexes、query-composite-indexes、monitor-explain-analyze;连接错误或超时对应 conn-pooling、conn-limits、conn-idle-timeout;死锁或长事务对应 lock-short-transactions、lock-deadlock-prevention;批量加载慢对应 data-batch-inserts、data-upsert;表膨胀或 VACUUM 问题对应 monitor-vacuum-analyze;JSONB 查询慢对应 advanced-jsonb-indexing;全文检索或搜索质量对应 advanced-full-text-search(可与 /postgres-semantic-search 搭配实现 BM25 加向量);安全或多租户对应 security-* 规则与 RLS。
使用方式:阅读各规则文件获取详细说明与 SQL 示例,如 references/query-missing-indexes.md、references/query-partial-indexes.md、references/_sections.md。每个规则文件包含:为何重要的简要说明、带解释的错误 SQL 示例、带解释的正确 SQL 示例、可选的 EXPLAIN 输出或指标、附加上下文与参考、以及适用时的 Supabase 专属说明。
相关技能:/postgres-semantic-search(pgvector 向量搜索、BM25 与语义混合、ParadeDB)、/nextjs-chatbot(聊天机器人编排、会话数据库、反馈、HITL)、/ai-sdk(后端集成的 AI SDK 模式)。
限制:资料未提供安装命令、收费或价格、平台支持范围等具体信息,暂未提供。