用途:对 PostgreSQL 相关代码做结构化审查,覆盖查询性能、JSONB、连接管理与事务安全,适合在评审 SQL 查询、DDL/迁移与连接代码时使用。
主要能力:按四类问题提供参考文档——索引缺失或类型错误、查询性能(references/indexes.md);JSONB 查询、操作符与 GIN 索引(references/jsonb.md);连接泄漏、连接池配置与超时(references/connections.md);隔离级别、死锁与咨询锁(references/transactions.md)。
使用方式:先确定审查范围,记录 SQL、DDL/迁移和连接代码的具体路径;再按需加载对应参考文档,并按清单逐项核对:WHERE/JOIN 列是否有合适索引、复合索引列顺序是否匹配查询模式、JSONB 列被查询时是否使用 GIN 索引及正确操作符(->、->>、@>、?)、连接池限制是否合理、连接是否正确释放(上下文管理器、try/finally)、事务隔离级别是否匹配场景、是否存在长事务持锁、应用级协调是否使用咨询锁、查询是否使用参数化语句。
约束与门槛:性能类结论(索引、顺序扫描、JSONB 操作符、执行计划)必须引用具体语句或模式(引文或文件:行);判定 SQL 注入风险前,必须先确认 SQL 与值的拼接方式(绑定参数还是字符串拼接/格式化/f-string),并指出所看到的机制;每个被审查子系统至少引用一个路径。
限制:资料未提供具体支持的 PostgreSQL 版本、安装方式或集成方式,暂未提供;实际效果取决于代码库与审查配置。