mcpField
S
supabase-postgres-best-practices

supabase-postgres-best-practices

github.com/julianromli数据与数据库21357 次安装4 天前更新
代码仓库

关于 supabase-postgres-best-practices

由 Supabase 维护的 Postgres 优化指南，面向编写 SQL、设计数据库及排查性能问题的开发者。规则按影响分为八类，并提供 SQL 示例说明做法。

主要功能

  1. 01按影响划分八类规则
  2. 02提供错误与正确的 SQL 示例
  3. 03索引与查询计划指导
  4. 04Postgres 安全及 RLS 指导
  5. 05连接与并发处理建议

适用场景

  1. 01排查缓慢的 Postgres 查询
  2. 02设计数据库结构与索引
  3. 03检查 Row-Level Security 策略
  4. 04调整连接池与扩展配置

安装

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

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

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

包含的文件

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

AGENTS.md
rules/
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-data-types.md
schema-foreign-key-indexes.md
schema-lowercase-identifiers.md
schema-partitioning.md
schema-primary-keys.md
security-privileges.md
security-rls-basics.md

详细介绍

Supabase Postgres 最佳实践

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

适用场景

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

  • 编写 SQL 查询或设计模式
  • 实现索引或查询优化
  • 审查数据库性能问题
  • 配置连接池或扩展
  • 针对 Postgres 特有功能进行优化
  • 处理行级安全性（RLS）

按优先级划分的规则类别

优先级类别影响前缀
1查询性能CRITICALquery-
2连接管理CRITICALconn-
3安全与 RLSCRITICALsecurity-
4模式设计HIGHschema-
5并发与锁定MEDIUM-HIGHlock-
6数据访问模式MEDIUMdata-
7监控与诊断LOW-MEDIUMmonitor-
8高级功能LOWadvanced-

使用方法

阅读各个规则文件以获取详细说明和 SQL 示例：

rules/query-missing-indexes.md
rules/schema-partial-indexes.md
rules/_sections.md

每个规则文件包含：

  • 简要说明其重要性
  • 带有说明的错误 SQL 示例
  • 带有说明的正确 SQL 示例
  • 可选的 EXPLAIN 输出或指标
  • 附加上下文和参考资料
  • Supabase 特有的注意事项（如适用）

完整编译文档

如需包含所有规则详细展开的完整指南：AGENTS.md

评论

支持 Markdown