关于 supabase-postgres-best-practices
面向 Postgres 开发者的性能优化指南，由 Supabase 维护。规则按影响分为 8 类，包含 SQL 示例，覆盖查询、连接管理、安全和模式设计等主题。
主要功能
- 01按影响划分的 8 类规则
- 02查询与索引优化建议
- 03连接管理与扩展指导
- 04安全与 RLS 指导
- 05错误和正确 SQL 示例
适用场景
- 01编写 SQL 查询或设计模式
- 02排查数据库性能问题
- 03配置连接池或扩展
- 04实现 Row-Level Security
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/supabase-postgres-best-practices确认已加载。
包含的文件
除 SKILL.md 外，安装时一起下载的参考资料和脚本。
AGENTS.mdmetadata.jsonREADME.mdrules/_contributing.md_sections.md_template.mdadvanced-full-text-search.mdadvanced-jsonb-indexing.mdconn-idle-timeout.mdconn-limits.mdconn-pooling.mdconn-prepared-statements.mddata-batch-inserts.mddata-n-plus-one.mddata-pagination.mddata-upsert.mdlock-advisory.mdlock-deadlock-prevention.mdlock-short-transactions.mdlock-skip-locked.mdmonitor-explain-analyze.mdmonitor-pg-stat-statements.mdmonitor-vacuum-analyze.mdquery-composite-indexes.mdquery-covering-indexes.mdquery-index-types.mdquery-missing-indexes.mdquery-partial-indexes.mdschema-data-types.mdschema-foreign-key-indexes.md详细介绍
Supabase Postgres 最佳实践
由 Supabase 维护的 Postgres 综合性能优化指南。包含 8 个类别的规则，按影响程度排序，用于指导自动化查询优化和模式设计。
适用场景
在以下情况下参考这些指南：
- 编写 SQL 查询或设计模式
- 实现索引或查询优化
- 审查数据库性能问题
- 配置连接池或扩展
- 针对 Postgres 特有功能进行优化
- 处理行级安全性（RLS）
按优先级划分的规则类别
| 优先级 | 类别 | 影响 | 前缀 |
|---|---|---|---|
| 1 | 查询性能 | CRITICAL | query- |
| 2 | 连接管理 | CRITICAL | conn- |
| 3 | 安全与 RLS | CRITICAL | security- |
| 4 | 模式设计 | HIGH | schema- |
| 5 | 并发与锁定 | MEDIUM-HIGH | lock- |
| 6 | 数据访问模式 | MEDIUM | data- |
| 7 | 监控与诊断 | LOW-MEDIUM | monitor- |
| 8 | 高级功能 | LOW | advanced- |
使用方法
阅读各个规则文件以获取详细说明和 SQL 示例：
rules/query-missing-indexes.md
rules/schema-partial-indexes.md
rules/_sections.md
每个规则文件包含：
- 简要说明其重要性
- 带有说明的错误 SQL 示例
- 带有说明的正确 SQL 示例
- 可选的 EXPLAIN 输出或指标
- 附加上下文和参考资料
- Supabase 特有的注意事项（如适用）
完整编译文档
如需包含所有规则详细展开的完整指南：AGENTS.md
评论
支持 Markdown