supabase-postgres-best-practices
来自 Supabase 的 Postgres 性能优化与最佳实践。在编写、审查或优化 Postgres 查询、数据库结构设计或数据库配置时,请使用此技能。
技能说明
来自 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 示例为典型场景演示,实际使用时请结合业务数据和执行计划验证。