mcpField
S
supabase-postgres-best-practices

supabase-postgres-best-practices

github.com/laguagu数据与数据库71138 次安装1 天前更新
代码仓库

关于 supabase-postgres-best-practices

Supabase Postgres Best Practices 是由 Supabase 维护的查询优化与数据库设计参考技能。其按优先级整理的规则涵盖性能、连接、安全、模式等 Postgres 主题，并为单项建议提供 SQL 示例。

主要功能

  1. 01涵盖八类 Postgres 指南
  2. 02按影响程度排列规则
  3. 03每条规则附 SQL 示例
  4. 04涉及 RLS 与连接池
  5. 05提供查询和 Vacuum 诊断

适用场景

  1. 01优化缓慢的 SQL 查询
  2. 02设计索引和数据库模式
  3. 03审查 RLS 与数据库安全
  4. 04排查连接或 Vacuum 问题

安装

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

$npx skills add https://github.com/laguagu/claude-code-nextjs-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）

快速决策树

Problem?
├─ Slow query → query-missing-indexes, query-composite-indexes, monitor-explain-analyze
├─ Connection errors / timeouts → conn-pooling, conn-limits, conn-idle-timeout
├─ Deadlocks / long transactions → lock-short-transactions, lock-deadlock-prevention
├─ Bulk load slow → data-batch-inserts, data-upsert
├─ Table bloat / VACUUM issues → monitor-vacuum-analyze
├─ JSONB queries slow → advanced-jsonb-indexing
├─ FTS / search quality → advanced-full-text-search (pair with /postgres-semantic-search for BM25 + vector)
└─ Security / multi-tenant → security-* rules, RLS

相关技能

  • /postgres-semantic-search — 向量搜索（pgvector）、混合 BM25 + 语义搜索、ParadeDB
  • /nextjs-chatbot — 聊天机器人编排、会话数据库、反馈、HITL
  • /ai-sdk — 用于后端集成的 AI SDK 模式

按优先级划分的规则类别

优先级类别影响前缀
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