用途：在应用 Pod 内对 PostgreSQL 数据库执行只读 SQL 查询（DEV 或 PROD），例如检查记录是否存在、统计行数或查看数据。环境无 psql，需通过 node -e 使用 pg 模块。
连接配置：从项目的 CLAUDE.md 的 ## Infrastructure 段读取项目相关值，包括 kubectl context、namespace、应用 Pod 标签、数据库名以及各环境配置文件。
使用方式：先读取 CLAUDE.md 获取连接信息；用 kubectl --context=<ctx> get pods -n <namespace> | grep <app-label> 查找运行中的 Pod；从 Pod 内配置文件获取连接详情；使用辅助脚本或内联 node -e 执行查询。可复用辅助脚本见 scripts/query.js（用 kubectl cp 复制到 Pod），命令模板见 references/query-examples.md。
限制与注意：PgBouncer 不支持参数化查询，需使用带引号值的内联 SQL；仅限只读，未获明确确认不得执行 INSERT/UPDATE/DELETE；必须使用 require('/app/node_modules/pg')，模块不在全局 node 路径中；DEV 用 development.config.js，PROD 用 production.config.js，两文件在每个 Pod 中都存在。常见错误包括未读 CLAUDE.md（namespace、context、数据库名因项目而异）、使用参数化查询（PgBouncer 会拒绝）、require('pg') 失败，以及在未确认时执行写查询。