shz-backend/.codex/skills/query-shz-highgo/SKILL.md

name, description

name	description
query-shz-highgo	通过 SSH 网关和受保护的只读 psql 流程查询测试或生产环境中的 SHZ HighGo Security Enterprise Edition 数据库。适用于 Codex 在 shz-backend 项目中检查数据库 schema、表、列、行数或应用数据，诊断数据相关行为，或对项目 HighGo 数据库执行 SELECT、WITH、SHOW 或 EXPLAIN 语句。

查询 SHZ HighGo 数据库

使用随附脚本，通过已配置的 SSH 网关执行只读 SQL。省略环境参数时查询生产环境；将 test 作为第一个参数传入以查询测试环境。

查询流程

1. 构造范围最小且有用的查询。检查数据行时增加较小的 LIMIT。

2. 对陌生表，先检查 information_schema.columns，再查询业务数据。

3. 运行：

   .codex/skills/query-shz-highgo/scripts/query.sh 'SELECT current_database(), current_user, current_schema()'
   
   # 测试环境
   .codex/skills/query-shz-highgo/scripts/query.sh test 'SELECT current_database(), current_user, current_schema()'
   

4. 总结查询结果，并区分返回的事实和推断。

脚本只接受以 SELECT、WITH、SHOW 或 EXPLAIN 开头的语句，拒绝多条语句，将 search_path 设置为 shz,public，启用数据库级只读模式，并设置 30 秒超时。不得绕过这些控制，也不得执行写入；除非用户明确要求，否则不得使用单独的可写流程。

发现 schema

列出用户表：

.codex/skills/query-shz-highgo/scripts/query.sh "SELECT table_schema, table_name FROM information_schema.tables WHERE table_schema NOT IN ('pg_catalog', 'information_schema') ORDER BY 1, 2"

检查列：

.codex/skills/query-shz-highgo/scripts/query.sh "SELECT column_name, data_type, is_nullable FROM information_schema.columns WHERE table_schema = 'shz' AND table_name = 'lowercase_table_name' ORDER BY ordinal_position"

HighGo 可能将未加引号的标识符以小写暴露，也可能将加引号的标识符保持精确大小写。无法确定拼写时，先查询 information_schema。

连接信息

只有在排查连接问题或更新端点时，才阅读 references/connection.md。不得打印、引用或暴露密码文件。