mcpField
S
supabase-postgres-best-practices

supabase-postgres-best-practices

官方
github.com/supabase数据与数据库2.9k464.3k 次安装4 周前更新
代码仓库

关于 supabase-postgres-best-practices

这是 Supabase 维护的 Postgres 性能优化指南，以 Agent 技能形式提供。内容按影响程度划分为 8 类规则，涵盖查询、连接、RLS、Schema 设计等方面，适合数据库开发者参考。

主要功能

  1. 01按影响程度排序的 8 类优化规则
  2. 02查询与索引优化示例
  3. 03连接池与扩展配置指导
  4. 04Row-Level Security 安全规则
  5. 05每条规则附带 SQL 正反示例

适用场景

  1. 01编写 SQL 查询或设计 Schema 时参考
  2. 02审查数据库性能问题
  3. 03配置连接池或规划扩容
#databases

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/supabase/agent-skills --skill supabase-postgres-best-practices

安装后在 Claude Code 中输入/supabase-postgres-best-practices确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

CHANGELOG.md
references/
_contributing.md
_sections.md
_template.md
advanced-full-text-search.md
advanced-jsonb-indexing.md
conn-idle-timeout.md
conn-limits.md
conn-pooling.md
conn-prepared-statements.md
data-batch-inserts.md
data-n-plus-one.md
data-pagination.md
data-upsert.md
lock-advisory.md
lock-deadlock-prevention.md
lock-short-transactions.md
lock-skip-locked.md
monitor-explain-analyze.md
monitor-pg-stat-statements.md
monitor-vacuum-analyze.md
query-composite-indexes.md
query-covering-indexes.md
query-index-types.md
query-missing-indexes.md
query-partial-indexes.md
schema-constraints.md
schema-data-types.md
schema-foreign-key-indexes.md
schema-lowercase-identifiers.md

详细介绍

Supabase Postgres 最佳实践

由 Supabase 维护的综合 Postgres 性能优化指南。包含 8 个类别的规则，并按影响程度排序，用于指导自动化查询优化和架构设计。

适用场景

在以下情况下参考这些指南：

  • 编写 SQL 查询或设计架构
  • 实现索引或优化查询
  • 排查数据库性能问题
  • 配置连接池或扩展规模
  • 针对 Postgres 特定功能进行优化
  • 使用行级安全（RLS）

按优先级划分的规则类别

优先级类别影响前缀
1查询性能严重query-
2连接管理严重conn-
3安全与 RLS严重security-
4架构设计高schema-
5并发与锁定中高lock-
6数据访问模式中data-
7监控与诊断中低monitor-
8高级功能低advanced-

使用方法

阅读各个规则文件，了解详细说明和 SQL 示例：

references/query-missing-indexes.md
references/query-partial-indexes.md
references/_sections.md

每个规则文件包含：

  • 对规则重要性的简要说明
  • 错误的 SQL 示例及说明
  • 正确的 SQL 示例及说明
  • 可选的 EXPLAIN 输出或指标
  • 补充背景信息和参考资料
  • Supabase 特定说明（如适用）

参考资料

评论

支持 Markdown