mcpField
S
supabase-postgres-best-practices

supabase-postgres-best-practices

github.com/makerjackie数据与数据库145 次安装36 周前更新
代码仓库

关于 supabase-postgres-best-practices

这是一项由 Supabase 维护的 PostgreSQL 优化技能，按影响程度整理性能、架构、安全和运维规则，面向编写或审查数据库查询与设计的开发者，并附有 SQL 示例。

主要功能

  1. 01覆盖八类优先级规则
  2. 02查询与索引优化指导
  3. 03连接管理与锁定实践
  4. 04安全与行级安全建议
  5. 05架构及数据访问模式
  6. 06附解释的 SQL 示例

适用场景

  1. 01排查缓慢的 PostgreSQL 查询
  2. 02设计数据库架构与索引
  3. 03配置连接池
  4. 04检查行级安全策略

安装

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

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

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

包含的文件

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

AGENTS.md
CLAUDE.md
references/
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
schema-partitioning.md
schema-primary-keys.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/schema-partial-indexes.md
references/_sections.md

每个规则文件都包含：

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

参考资料

评论

支持 Markdown