让 AI 自动检查 Postgres 查询与架构规范

解决数据库性能瓶颈:AI 依据 Supabase 维护的 8 大类规范(如查询性能、连接管理、安全性),自动审查 SQL 语句、索引设计和架构配置,输出优化建议与修正代码。

为什么需要这个技能

Postgres 性能问题往往隐藏在复杂的 SQL 逻辑或不当的架构设计里。手动优化耗时且容易遗漏关键点。

Supabase 官方社区贡献了一套涵盖 8 大优先级的最佳实践指南。该技能让 AI 依据这套标准,自动识别慢查询、缺失索引、连接池耗尽风险及 RLS 配置错误,帮助开发者快速建立稳健的数据库系统。

适用场景

  • 编写新 SQL 查询或设计数据库 Schema 时。
  • 审查现有代码库中的数据库层,排查潜在的性能隐患。
  • 配置数据库连接池、扩展或高级功能(如 JSON 处理)时。
  • 需要对比不同索引策略对查询结果集的影响时。

核心工作流

  1. 明确优化目标:AI 根据任务决定是检查完整文档还是聚焦特定规则。
  2. 读取规则详情:参考 rules/ 目录下的具体文件,如缺失索引 (query-missing-indexes.md) 或局部索引 (schema-partial-indexes.md)。
  3. 分析并输出建议:AI 对比错误 SQL 与正确写法,提供 EXPLAIN 分析或 Supabase 特定配置提示。
  4. 生成完整报告:如需全面审查,AI 综合 AGENTS.md 中的完整指南,给出系统性优化方案。

下载和安装

下载 postgres-best-practices 中文版 Skill ZIP

解压后将目录放入你的 AI 工具 skills 文件夹,重启工具即可使用。具体配置参考内附的 USAGE.zh.md

你可能还需要

暂无推荐