supabase-postgres-best-practices

来自 Supabase 的 Postgres 性能优化与最佳实践。在编写、审查或优化 Postgres 查询、数据库结构设计或数据库配置时,请使用此技能。

提供方:星战科技调用次数:0收藏:0更新:2026/08/28

技能说明

来自 Supabase 的 Postgres 性能优化与最佳实践。在编写、审查或优化 Postgres 查询、数据库结构设计或数据库配置时,请使用此技能。

技能简介

本技能提供由 Supabase 维护的 Postgres 性能优化与最佳实践指南,涵盖查询优化、Schema 设计、连接管理、安全与 RLS 等 8 大类别。可用于编写、审查或优化 Postgres 查询、数据库结构及配置,帮助开发者提升数据库性能与稳定性。

使用场景

  • 编写 SQL 查询或设计数据库 Schema 时
  • 实施索引策略或进行查询优化
  • 排查数据库性能问题
  • 配置连接池或数据库扩展
  • 使用 Row-Level Security(RLS)或 Postgres 特定功能

使用方法

启用该技能后,可按需查阅 rules/ 目录下的规则文件,例如:

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

每个规则文件均包含:规则说明、错误 SQL 示例及解释、正确 SQL 示例及解释、可选的 EXPLAIN 输出或指标、补充上下文与参考链接、Supabase 特定说明。

完整指南(含所有规则详解)见 AGENTS.md。规则按优先级排列,建议优先处理标记为 CRITICAL 的类别(Query Performance、Connection Management、Security & RLS),其次为 HIGH(Schema Design)及 MEDIUM 级别类别。

注意事项

  • 规则文件按前缀区分类别(如 query-conn-security-),便于检索。
  • 不同类别的优先级和影响程度不同,请根据实际场景选择合适的规则先行应用。
  • 规则文件中的 SQL 示例为典型场景演示,实际使用时请结合业务数据和执行计划验证。