Postgres 查询与架构优化 Skill 技能

技能简介

sickn33-postgres-best-practices 是一套面向 PostgreSQL / Supabase 的性能与架构优化 Skill，给 Claude、Codex、Claude Code 提供结构化的数据库最佳实践指导。普通代码评审很难发现慢查询隐患和不安全的数据库模式，这个技能把索引选型、Schema 设计、连接池、事务、RLS 权限、监控诊断等经验沉淀成可执行的审查清单。Skillstore 质量分 80（silver 档），版本 1.0.0，MIT 许可，已完成安全审计——静态扫描命中的"可疑模式"经复核全部是 SQL 示例与文档内容。

核心能力

• 查询体检：审查 SQL 的缺失索引、低效过滤条件和糟糕的 JOIN 模式，给出更优写法。
• 索引选型：按查询形态推荐 B-tree、GIN、BRIN、hash、复合、覆盖、部分索引等具体类型。
• Schema 设计：指导数据类型、外键索引、分区、主键与命名规范，兼顾未来扩展。
• 连接与事务：讲解连接池、连接上限、空闲超时、预编译语句的取舍，以及事务范围与锁模式。
• 安全加固：优化 RLS 策略、权限授予、队列处理，落实最小权限。
• 监控诊断：运用 pg_stat_statements、VACUUM、ANALYZE、EXPLAIN ANALYZE 等内置工具。

安装配置

1. 执行 npx skillstore add sickn33/postgres-best-practices 安装。
2. 准备可复现的现场：慢查询日志、Schema 迁移脚本或 EXPLAIN 输出，指导质量取决于输入证据。
3. 涉及管理类 SQL（VACUUM、索引创建、权限变更）时，先在预发环境验证再上生产。
4. 技能包含脚本、网络与外部命令风险项，建议在受控环境运行。

使用步骤

1. 发布前查慢查询：把查询交给 Agent，对照过滤、JOIN、分页、选择列逐项核对索引规则。
2. 评审 Schema 迁移：检查数据类型、主键、外键索引、命名与扩展风险，获取精确的迁移修改建议。
3. 优化多租户架构：规划主键、RLS 策略、外键索引、分区与数据类型。
4. 调优 Supabase：审查连接池、空闲超时、预编译语句与监控查询。
5. 制定生产调优计划：结合查询、Schema 与负载约束，输出含索引、池化、事务、监控、上线风险的优先级清单。

适用场景

• 上线前的慢查询评审与索引优化
• 多租户 SaaS 的数据库架构设计
• Supabase 连接池与 RLS 策略调优
• 数据库迁移脚本的安全评审

适用人群

后端工程师、DBA、全栈开发者，以及使用 Supabase/Postgres 做产品开发的独立开发者和中小团队。

工作原理

技能内置 Postgres 查询优化与安全规范知识库，Agent 拿到查询或迁移脚本后，按检查维度逐项比对规则，识别缺失索引、低效模式与权限隐患，并给出带理由的修改建议。它输出的是指导而非自动执行——推荐结论需要结合真实负载、数据量和 Postgres 版本用执行计划验证，管理类 SQL 必须人工审核后应用。

官方链接

• 技能主页：https://skillstore.io/skills/sickn33-postgres-best-practices
• 源码仓库：https://github.com/sickn33/antigravity-awesome-skills