# postgres-query

Скилл postgres-query для Claude Code выполняет запросы к PostgreSQL при отладке и профилировании базы данных. Запускает команды через скрипт с обязательным указанием контура --prod или --dev.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 105 установок · ★ 7327 у репозитория
- Автор: civitai
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/civitai/civitai/tree/HEAD/.claude/skills/postgres-query/SKILL.md
- Обновлён: 2026-10-25
- Проверка безопасности: автоматическая, 2026-11-17 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/civitai-postgres-query

## Что делает

Выполняет SQL-запросы через Node.js-скрипт `query.mjs`, подключаясь по умолчанию в режиме только для чтения к реплике. Поддерживает явный выбор базы флагами `--prod`, `--dev`, `--data-packet` и `--notifications`. Два флага окружения одновременно передавать нельзя, а неизвестные параметры отклоняются сразу.

Перед отправкой запроса скрипт выводит в `stderr` адрес и порт базы, полученные драйвером `pg`. База для `--dev` требует поднятого SSH-туннеля к внутренней сети. Конфигурация считывается из файла `.claude/skills/postgres-query/.env`, при этом все контуры кроме dev отклоняют адреса из корневого `.env` проекта.

Для анализа планов выполнения доступен флаг `--explain` с запуском `EXPLAIN ANALYZE`, поддерживается структурированный вывод через `--json` и передача SQL из файла с помощью `-f`. Запись в базу открывается флагом `--writable`, но на репликах `--data-packet` и `--notifications` он запрещён.

## Требования
- Работает с: PostgreSQL

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add civitai/civitai --skill postgres-query -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/postgres-query/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/postgres-query/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add civitai/civitai --skill postgres-query -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/postgres-query/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add civitai/civitai --skill postgres-query -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/postgres-query/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install civitai/civitai .claude/skills/postgres-query
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/postgres-query/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add civitai/civitai --skill postgres-query -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/civitai/civitai --path .claude/skills/postgres-query
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/postgres-query/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add civitai/civitai --skill postgres-query -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/civitai/civitai/tree/HEAD/.claude/skills/postgres-query/SKILL.md

## Когда брать
- выполнить `EXPLAIN ANALYZE` для поиска узких мест в SQL
- проверить выборку данных на рабочей реплике без риска случайной записи
- применить DDL или тестовую миграцию на dev-базе через `--writable`
- запустить длинный запрос из файла `.sql` с увеличенным таймаутом

## Примеры запросов агенту
- Выполни профилирование запроса на проде: `node .claude/skills/postgres-query/query.mjs --prod --explain "SELECT * FROM \"User\" LIMIT 5"`
- Запусти запрос из файла на dev-базе: `node .claude/skills/postgres-query/query.mjs --dev -f my-query.sql`
- Выгрузи список записей в JSON с таймаутом 60 секунд: `node .claude/skills/postgres-query/query.mjs --prod --json -t 60 "SELECT id FROM \"Model\" LIMIT 10"`

## Похожие
- [neon-postgres](https://affpapa.org/nevibecode/skills/neondatabase-neon-postgres.md) — скилл · 315000 установок
- [postgres-patterns](https://affpapa.org/nevibecode/skills/postgres-patterns.md) — скилл · 7200 установок
- [design-postgres-tables](https://affpapa.org/nevibecode/skills/design-postgres-tables.md) — скилл · 680 установок
- [supabase-postgres-best-practices](https://affpapa.org/nevibecode/skills/supabase-postgres-best-practices-2.md) — скилл · 146 установок
- [postgres-tuning](https://affpapa.org/nevibecode/skills/postgres-tuning.md) — скилл · 136 установок

## Другие версии с тем же именем
- [postgres-query · civitai](https://affpapa.org/nevibecode/skills/postgres-query.md) — ★ 7327 у репозитория

Из того же набора: [civitai/civitai](https://affpapa.org/nevibecode/by/civitai/civitai.md) — 11 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
