⚠️

重要前提

安装AI Skills的关键前提是：必须科学上网，且开启TUN模式，这一点至关重要，直接决定安装能否顺利完成，在此郑重提醒三遍：科学上网，科学上网，科学上网。查看完整安装教程 →

PostgreSQL查询测试工具 - 数据库调试、性能分析与SQL优化

postgres-query by civitai/civitai

64 周安装量

7,100 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/civitai/civitai --skill postgres-query

Node.js 数据库测试

🇨🇳中文介绍

PostgreSQL 查询测试

使用此技能来运行即席 PostgreSQL 查询，用于测试、调试和性能分析。

运行查询

使用包含的查询脚本：

node .claude/skills/postgres-query/query.mjs "SELECT * FROM \"User\" LIMIT 5"

选项

标志	描述
`--explain`	在查询上运行 EXPLAIN ANALYZE
`--writable`	使用主数据库而非只读副本（需要用户权限）
`--timeout <s>`, `-t`	查询超时时间（单位：秒，默认：30）
,

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

相关 Skills

Azure PostgreSQL 无密码身份验证配置指南：Entra ID 迁移与访问管理

34,800 周安装

minimal-run-and-audit：AI论文复现执行与审计技能，标准化测试与报告

25,300 周安装

Web应用安全最佳实践指南：HTTPS、输入验证、CSRF防护与合规性

14,100 周安装

PostgreSQL表设计最佳实践：核心规则、数据类型选择与常见陷阱详解

13,000 周安装

# 简单查询
node .claude/skills/postgres-query/query.mjs "SELECT id, username FROM \"User\" LIMIT 5"

# 检查查询性能
node .claude/skills/postgres-query/query.mjs --explain "SELECT * FROM \"Model\" WHERE id = 1"

# 为长时间运行的查询覆盖默认的 30 秒超时
node .claude/skills/postgres-query/query.mjs --timeout 60 "SELECT ... (复杂查询)"

# 从文件读取查询
node .claude/skills/postgres-query/query.mjs -f my-query.sql

# 用于处理的 JSON 输出
node .claude/skills/postgres-query/query.mjs --json "SELECT id, username FROM \"User\" LIMIT 3"

默认只读 ：使用 DATABASE_REPLICA_URL 以防止意外写入
写入保护 ：除非使用 --writable 标志，否则会阻止 INSERT/UPDATE/DELETE/DROP 操作
需要明确权限 ：在使用 --writable 之前，您必须请求用户许可

何时使用 --writable

仅在以下情况下使用 --writable 标志：

用户明确请求写入权限
您需要测试写入操作
您正在验证事务行为

重要提示 ：在运行 --writable 之前，务必请求用户许可。

要比较两种查询方法：

# 运行第一种方法
node .claude/skills/postgres-query/query.mjs --explain "SELECT ... (方法 1)"

# 运行第二种方法
node .claude/skills/postgres-query/query.mjs --explain "SELECT ... (方法 2)"

# 比较实际结果
node .claude/skills/postgres-query/query.mjs --json "SELECT ... (方法 1)" > /tmp/q1.json
node .claude/skills/postgres-query/query.mjs --json "SELECT ... (方法 2)" > /tmp/q2.json

验证索引使用情况

使用 --explain 运行并查找：

良好："Index Scan"、"Bitmap Index Scan"、"Index Only Scan"
不佳：在大表上进行 "Seq Scan"（表明索引缺失或未使用）

node .claude/skills/postgres-query/query.mjs --explain "SELECT * FROM "Account" WHERE provider = 'discord'"

🇺🇸English

PostgreSQL Query Testing

Use this skill to run ad-hoc PostgreSQL queries for testing, debugging, and performance analysis.

Running Queries

Use the included query script:

node .claude/skills/postgres-query/query.mjs "SELECT * FROM \"User\" LIMIT 5"

Options

Flag	Description
`--explain`	Run EXPLAIN ANALYZE on the query
`--writable`	Use primary database instead of read replica (requires user permission)
`--timeout <s>`, `-t`	Query timeout in seconds (default: 30)
`--file`, `-f`	Read query from a file
`--json`	Output results as JSON
`--quiet`, `-q`	Minimal output, only results

Examples

# Simple query
node .claude/skills/postgres-query/query.mjs "SELECT id, username FROM \"User\" LIMIT 5"

# Check query performance
node .claude/skills/postgres-query/query.mjs --explain "SELECT * FROM \"Model\" WHERE id = 1"

# Override default 30s timeout for longer queries
node .claude/skills/postgres-query/query.mjs --timeout 60 "SELECT ... (complex query)"

# Query from file
node .claude/skills/postgres-query/query.mjs -f my-query.sql

# JSON output for processing
node .claude/skills/postgres-query/query.mjs --json "SELECT id, username FROM \"User\" LIMIT 3"

Safety Features

Read-only by default : Uses DATABASE_REPLICA_URL to prevent accidental writes
Write protection : Blocks INSERT/UPDATE/DELETE/DROP unless --writable flag is used
Explicit permission required : Before using --writable, you MUST ask the user for permission

When to Use --writable

Only use the --writable flag when:

The user explicitly requests write access
You need to test write operations
You're verifying transaction behavior

IMPORTANT : Always ask the user for permission before running with --writable.

Comparing Query Performance

To compare two query approaches:

# Run first approach
node .claude/skills/postgres-query/query.mjs --explain "SELECT ... (approach 1)"

# Run second approach
node .claude/skills/postgres-query/query.mjs --explain "SELECT ... (approach 2)"

# Compare actual results
node .claude/skills/postgres-query/query.mjs --json "SELECT ... (approach 1)" > /tmp/q1.json
node .claude/skills/postgres-query/query.mjs --json "SELECT ... (approach 2)" > /tmp/q2.json

Verifying Index Usage

Run with --explain and look for:

Good : "Index Scan", "Bitmap Index Scan", "Index Only Scan"
Bad : "Seq Scan" on large tables (indicates missing or unused index)

node .claude/skills/postgres-query/query.mjs --explain "SELECT * FROM "Account" WHERE provider = 'discord'"

Weekly Installs

Repository

civitai/civitai

GitHub Stars

7.0K

First Seen

Jan 23, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

gemini-cli44

opencode44

codex42

github-copilot42

claude-code41

cursor39

代码审查最佳实践指南：完整流程、安全与性能审查清单

12,400 周安装