Communitygithub.com

Supabase Postgres 最佳实践

由 Supabase 维护的 Postgres 最佳实践指南,适用于任何运行 Postgres 的环境。在编写或修改任何与 Postgres 数据库相关的内容之前加载此技能:创建或修改表和列(包括选择列类型)、模式设计、迁移和声明式模式文件、RLS 策略及其验证测试、索引、触发器、数据库函数、队列和定时任务、向量/语义搜索以及恢复转储或导入数据。在诊断慢查询、高 CPU、超时、EXPLAIN 计划、连接耗尽、锁争用、数据膨胀或行对错误用户/租户可见时也应加载。这不仅是一份性能指南——即使是一次列变更或单条查询,模式、迁移、安全和 SQL 编写任务也需要遵循这些规则。

Supabase Postgres 最佳实践 是什么?

这份技能文档是由 Supabase 维护的全面 Postgres 性能优化指南,适用于在任何环境中运行的 Postgres 数据库。它涵盖了8个优先级排序的规则类别,包括查询性能、连接管理、安全与RLS、模式设计、并发与锁争用、数据访问模式、监控与诊断以及高级功能。对于开发者而言,在编写或修改任何数据库对象(如表、索引、触发器、函数)时,或者在诊断性能问题(如慢查询、高CPU、连接耗尽)时,都应加载此技能。每个规则文件都提供了详细的解释、不正确的SQL示例、正确的SQL示例以及可选的EXPLAIN输出或指标,并特别标注了Supabase相关的注意事项。该技能支持的平台包括Claude Code、Cursor、Codex等AI编码助手,通过引用特定规则文件(如 query-missing-indexes.md)来指导自动化查询优化和模式设计。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Futurists2023/tiktok/tree/HEAD/.agents/skills/supabase-postgres-best-practices

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Supabase Postgres 最佳实践 是做什么的?

由 Supabase 维护的全面性能优化指南,适用于 Postgres。包含8个类别,按影响优先级排序,以指导自动化查询优化和模式设计。

何时应用

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

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

按优先级排序的规则类别

优先级类别影响前缀
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 的说明(如适用)

参考

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相关技能