SuperAPI AI 工具集

pg-data

数据与分析

查看项目

更新于 10-16 06:15

技能介绍

用途:pg-data 技能把用户的自然语言需求转换为安全、可用于生产的 PostgreSQL SELECT 查询,并针对 blog_small、ecommerce_medium、saas_crm_large 三个数据库执行与验证。适合内容分析、销售与库存分析、CRM 管道与工单分析等场景。

主要能力:解析请求确定目标数据库与查询意图;读取对应 schema 参考文件(表结构、外键、视图、常见查询模式);生成带别名、合理 LIMIT 的 SQL;执行前做安全校验;用 psql 执行并最多重试 3 次;对结果给出 0-10 置信度评分,低于 7 分时重新生成或请求澄清。

使用方式:先判断数据库归属(博客内容→blog_small,商品订单→ecommerce_medium,线索商机工单→saas_crm_large),再读取参考文件:cat .claude/skills/pg-data/references/<database_name>.md,然后生成 SQL 并执行:PGPASSWORD=postgres psql -h localhost -p 5432 -U postgres -d <database_name> -c "<SQL_QUERY>"。用户若要求“只给 SQL”则仅返回查询,否则默认执行并返回结果。

安全限制:仅允许 SELECT、只读聚合函数、JOIN、子查询、CTE、窗口函数及 WHERE/GROUP BY/HAVING/ORDER BY/LIMIT;禁止 INSERT、UPDATE、DELETE、TRUNCATE、DROP、ALTER、CREATE、EXECUTE、CALL、DO、COPY、SET、RESET、pg_sleep、pg_terminate_backend 等写操作与系统函数,禁止动态 SQL、敏感字段(密码、API key、token、hash)暴露,并需防注入。saas_crm_large 需按 organization_id 遵守多租户边界。结果默认截断为前 100 行。

限制:具体数据库连接信息、部署环境与可用性暂未提供;参考文件内容与完整 schema 暂未提供。