技能介绍

你在优化什么

在 Supabase 或自建 Postgres 上，慢查询、连接打满、RLS 策略写错、锁等待和表结构设计不当，往往混在一起出现。单靠零散博客或文档片段很难判断「先改索引还是先改连接池」。本技能整理的是 Supabase 侧维护的 Postgres 综合性能与架构规则，按影响优先级排序，方便在写 SQL、做评审或排障时对照，而不是替代官方文档全文。

技能如何组织内容

规则按 8 个类别划分，并带有统一前缀，便于在对话里点名某条规则：

查询性能（query-）：索引、执行计划、常见反模式
连接管理（conn-）：池化、连接数与超时
安全与 RLS（security-）：行级安全与策略对性能的影响
架构设计（schema-）、并发与锁定（lock-）、数据访问模式（data-）等其余类别，覆盖从中到低的优先级场景

每条规则文件通常包含：为何重要、错误 SQL 与说明、推荐写法、可选的 EXPLAIN 或指标说明，以及适用的 Supabase 注释。使用方式是按需阅读对应规则，在改查询或设计表结构前先做对照，而不是一次性背完全部条目。

适用边界

内容面向 PostgreSQL / Supabase Database 语境；若你用的是其他数据库或仅用 Supabase Auth/Storage 而不碰 SQL，多数规则并不直接适用。规则是指导性清单，具体阈值（连接数、实例规格）仍要以你当前项目的监控与 Supabase/Postgres 官方文档为准；涉及 RLS 与权限时，应在测试环境验证策略后再上线。