SuperAPI AI 工具集

postgres-agents-query-reviewer

数据与分析

查看项目

更新于 10-16 06:18

技能介绍

用途:把 Claude 变成 SQL 查询审查员,用于上线前审查查询的正确性与性能,或审计代码库中的既有查询。它是编排型技能,不是语法参考,定义了固定的 13 项检查清单、严重度分级,以及每条发现应引用哪个兄弟技能。

主要能力:审查流程为 PARSE(识别语句类型、目标表、WHERE/JOIN/ORDER、子查询)、CHECK(执行全部 13 项检查 C-1..C-13 并记录命中)、EXPLAIN(对索引相关命中建议 EXPLAIN (ANALYZE, BUFFERS))、REPORT(输出结构化发现与总体结论)。严重度分 CRITICAL(正确性缺陷或数据丢失风险,结论不能为 APPROVE)、WARNING(规模化后才暴露的性能缺陷)、INFO(风格或依赖上下文)。结论为 APPROVE、APPROVE WITH WARNINGS 或 REQUEST CHANGES。检查项涵盖 SELECT *、无 WHERE 的 UPDATE/DELETE、隐式类型转换、JSONB 无 GIN 索引、索引列上函数调用、前导通配符 LIKE、N+1、大偏移 OFFSET、窗口函数与 GROUP BY 不匹配、可空列上的 NOT IN、无 LIMIT 的 ORDER BY、缺失索引、DISTINCT/GROUP BY 掩盖连接扇出。

使用方式:用户要求审查查询、询问 SQL 是否好或为何慢、粘贴 SQL 求反馈,审计代码库或迁移/PR diff 中的查询,或其他智能体产出的 SQL 上线前需检查时使用。输出为发现列表加一行结论,每条含严重度、位置、问题、修复与引用。

限制:不用于从零编写新 SQL、仅审查 schema DDL(用 postgres-agents-schema-reviewer)、审查迁移安全与锁(用 postgres-agents-migration-reviewer)。索引相关发现需 EXPLAIN 计划确认前只能标为疑似;不得在不知表大小的情况下把 Seq Scan 判为缺陷。反模式包括走过场批准、Seq Scan 恐惧症、仅语法审查、严重度膨胀、不引用修复技能。参考文件与官方文档链接见资料,具体内容暂未提供。