Supabase Postgres 性能指南
帮助 AI 智能体优化 Postgres 查询、模式设计与数据库配置。
技能主要提供SQL建议，没有凭据窃取、隐蔽外传或恶意代码证据；但示例包含ALTER SYSTEM、连接超时和连接上限修改，未要求用户确认、说明环境影响或提供回滚步骤，也未系统披露数据流和敏感数据处理方式。MIT许可和引用的官方资料有助于归因，但发布者身份未获验证且维护责任不够明确，因此扣分。
SKILL.md给出明确的触发场景、规则前缀和参考文件结构，仓库CI及sanity测试能验证安装路径；但测试未覆盖SQL建议的关键路径、异常输入或数据库行为，且版本元数据与CHANGELOG不一致（1.1.1对1.4.0），部分配置示例和计算公式缺少可诊断的失败反馈。静态证据不足，分数不超过10。
目标用户、Postgres/Supabase场景和八类主题描述清楚，语义触发条件较具体；但未明确非适用范围、输入输出边界、何时必须结合实际EXPLAIN或数据库环境，未提供中文使用支持证据。核心内容是本地文档，未因海外服务可达性额外扣分，但外部参考链接的可达性未说明。
文档有分层结构、规则命名约定、模板、示例、MIT许可证、版本字段和CHANGELOG，且仓库提供安装说明与CI；但选定技能的元数据版本落后于CHANGELOG，缺少明确维护负责人、更新路径、故障排查和已知限制，部分内容依赖未随技能清单展示的完整references集合。
多个规则包含错误/正确SQL、索引或配置示例，能够直接支持常见优化任务，且对安装有可用说明；但本次证据只展示少量规则，无法验证其声称覆盖八类内容的完整性，量化收益缺少验证，连接配置示例可能需要较多环境审查。静态校准限制有效性不超过7。
引用了PostgreSQL和Supabase等可审计的一手资料，仓库还包含CI和安装sanity测试；但没有覆盖规则正确性的测试、真实EXPLAIN结果或第三方执行证据，性能数字主要是文档声明，且未展示完整规则集合。静态证据支持有限可追溯性，因此不超过5。
- 执行ALTER SYSTEM、连接超时或max_connections示例前，应确认权限、生产环境影响、现有配置和回滚方案。
- 不要将文档中的10x、100x等性能数字视为保证；应在目标数据量、版本和工作负载上使用EXPLAIN和基准测试验证。
- 请核对SKILL.md的1.1.1版本与CHANGELOG的1.4.0版本，并确认完整references文件是否与当前修订一致。
它能做什么 & 适用场景
这是 Supabase 维护的 Postgres 性能优化技能，面向使用 Supabase 和 Postgres 的开发者。它按影响优先级覆盖查询性能、连接管理、安全与 RLS、模式设计、并发锁、数据访问、监控诊断和高级特性八类规则。每条规则提供原因说明、错误与正确 SQL 示例，并可能包含查询计划、性能指标和 Supabase 特定说明。该技能适合需要编写、审查或优化 Postgres 数据库代码的场景。
引导 AI 智能体读取 references/ 中的规则文件，依据八类 Postgres 规则审查 SQL 查询、索引、模式设计、连接池、扩展特性和 Row-Level Security 配置，并使用错误与正确 SQL 示例、EXPLAIN 输出或性能指标提出优化建议。
- 开发者编写新的 Postgres 查询，需要检查索引和查询性能时。
- 数据库工程师设计或审查 Supabase 数据库模式时。
- 团队排查慢查询、连接管理或并发锁问题时。
- 开发者配置 Row-Level Security，需要结合 Supabase 规则检查安全性时。
- 需要针对 Postgres 特性评估数据访问模式或数据库配置时。
优缺点一览
- 覆盖八个按影响排序的 Postgres 性能与设计类别。
- 规则包含错误与正确 SQL 示例，部分规则还提供查询计划和性能指标。
- 明确涵盖 Supabase 场景，包括 RLS、连接池和 Postgres 特性。
- 采用 MIT 许可证。
- 范围仅针对 Supabase/Postgres 最佳实践，不是完整的 Supabase 开发技能。
- 来源未提供测试套件、运行时脚本或具体平台验证矩阵。
- 规则细节位于独立引用文件中，当前提供的材料未展示全部规则内容。
如何安装
安装整个仓库：npx skills add supabase/agent-skills。只安装此技能：npx skills add supabase/agent-skills --skill supabase-postgres-best-practices。README 还提供了作为 Claude Code 插件安装的方法。
如何使用
安装后，在相关任务中直接提出请求，例如：Optimize this Postgres query、Review my schema for performance issues 或 Help me add proper indexes to this table。具体自动发现机制之外的客户端配置未在来源中说明。