pg_dump — скилл для Claude Code: что делает и как установить
Направляет ИИ-агента к исходникам утилиты pg_dump для извлечения схем и запросов к системным каталогам PostgreSQL 14–18.
Apache-2.0 1 установок ★ 1 089 обновлён 2026-10-28
npx skills add pgplex/pgschema --skill pg_dump -a claude-codeЧто делает pg_dump
Скилл содержит справочник по исходному коду pg_dump из официального репозитория PostgreSQL (src/bin/pg_dump/). Он сопоставляет типы объектов базы данных — таблицы, триггеры, индексы, представления и политики RLS — с функциями парсинга и таблицами системного каталога вроде pg_class, pg_trigger или pg_constraint.
Внутри описан порядок переноса логики каталожных запросов в код проекта pgschema на Go: привязка параметров через pgx, обработка NULL и вызовы вспомогательных функций вроде pg_get_expr или pg_get_triggerdef. Например, для условий WHEN в триггерах инструкция требует читать pg_catalog.pg_trigger, запрещая использовать information_schema.
Материал рассчитан только на версии PostgreSQL с 14 по 18 и сфокусирован на структуре схемы. Логику архивации, форматирование вывода и совместимость со старыми версиями переносить нельзя.
Какие задачи решает
- Написать точный SQL-запрос к системным каталогам PostgreSQL для нового типа объектов
- Получить корректный DDL триггеров и индексов через вспомогательные функции
pg_get_* - Адаптировать каталожные выборки
pg_dumpпод Go-драйверpgxвir/inspector.go - Настроить ветвление запросов под различия между версиями PostgreSQL 14–18
Примеры запросов агенту
- Посмотри реализацию
getTriggers()вpg_dump.cи напиши запрос дляir/inspector.go. - Как
pg_dumpизвлекает условияWHENдля триггеров без использованияinformation_schema? - Сверь запрос к
pg_constraintс кодомgetConstraints()для поддержки PostgreSQL 16.
Как установить pg_dump
1Через Skills CLI (Vercel)
npx skills add pgplex/pgschema --skill pg_dump -a claude-code2Вручную: положить файлы
~/.claude/skills/pg_dump/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/pg_dump/
1Через Skills CLI (Vercel)
npx skills add pgplex/pgschema --skill pg_dump -a codex2Вручную: положить файлы
.agents/skills/pg_dump/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add pgplex/pgschema --skill pg_dump -a cursor2Вручную: положить файлы
.cursor/skills/pg_dump/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install pgplex/pgschema .claude/skills/pg_dump2Вручную: положить файлы
.github/skills/pg_dump/SKILL.md1Через Skills CLI (Vercel)
npx skills add pgplex/pgschema --skill pg_dump -a gemini-cli2Командой платформы
gemini skills install https://github.com/pgplex/pgschema --path .claude/skills/pg_dumpВручную: положить файлы
.devin/skills/pg_dump/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add pgplex/pgschema --skill pg_dump -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о pg_dump
Как установить pg_dump в Claude Code?
Выполните команду npx skills add pgplex/pgschema --skill pg_dump -a claude-code в терминале.
Для чего нужен этот скилл?
Он помогает агенту правильно запрашивать метаданные системных каталогов PostgreSQL, ориентируясь на проверенную реализацию pg_dump.
Какие версии PostgreSQL поддерживаются?
Справочник ориентирован на PostgreSQL версий с 14 по 18; совместимость с более ранними выпусками не предусмотрена.
Исходный текст
SKILL.md · Apache-2.0
--- name: pg_dump description: Consult PostgreSQL's pg_dump implementation for guidance on system catalog queries and schema extraction when implementing pgschema features. Use this skill when adding new schema object support, debugging inspector.go queries, understanding how PostgreSQL represents objects internally, or handling version-specific features across PostgreSQL 14-18. --- # pg_dump Reference Reference pg_dump's implementation for correct system catalog queries and schema extraction patterns. ## Source **Repository**: https://github.com/postgres/postgres/blob/master/src/bin/pg_dump/ **Key files**: - `pg_dump.c` - Main implementation with all system catalog queries - `pg_dump.h` - Data structures - `pg_dump_sort.c` - Dependency sorting - `common.c` - Shared catalog query utilities ## Object Type → pg_dump Function → System Catalogs | Object | Function | Catalogs | |--------|----------|----------| | Tables & Columns | `getTables()` | `pg_class`, `pg_attribute`, `pg_type` | | Constraints | `getConstraints()` | `pg_constraint` | | Indexes | `getIndexes()` | `pg_index`, `pg_class` | | Triggers | `getTriggers()` | `pg_trigger`, `pg_proc` | | Functions | `getFuncs()` | `pg_proc` | | Views | `getViews()` | `pg_class`, `pg_rewrite` | | Sequences | `getSequences()` | `pg_sequence`, `pg_class` | | Policies | `getPolicies()` | `pg_policy` | | Types | `getTypes()` | `pg_type` | | Aggregates | `getAggregates()` | `pg_aggregate`, `pg_proc` | | Comments | `getComments()` | `pg_description` | ## Key Helper Functions - `pg_get_expr(expr, relation, pretty)` - Deparse expressions (defaults, WHEN clauses, index predicates) - `pg_get_constraintdef(oid, pretty)` - Get constraint DDL - `pg_get_indexdef(oid, column, pretty)` - Get index DDL - `pg_get_triggerdef(oid, pretty)` - Get full trigger DDL **Important**: For trigger WHEN clauses, always use `pg_get_expr(t.tgqual, t.tgrelid, false)` from `pg_catalog.pg_trigger`. Do NOT use `information_schema.triggers.action_condition`. ## Workflow 1. **Identify the object type** you're implementing 2. **Find the pg_dump function** from the table above 3. **Read the system catalog query** — note which columns, joins, and helper functions are used 4. **Check version-specific handling** — pg_dump uses `fout->remoteVersion` checks 5. **Adapt for pgschema** in `ir/inspector.go` or `ir/queries/`: - Use pgx parameter binding - Handle NULLs appropriately - Add version detection if needed ## When pg_dump is Authoritative Always reference for: system catalog query patterns, correct use of `pg_get_*` functions, version-specific feature detection, object dependency tracking. ## When NOT to Copy pg_dump Don't copy: output formatting (pgschema has different conventions), archive/restore logic, full-database scope (pgschema is schema-focused), pre-PG14 compatibility. ## pgschema Adaptation Pattern ```go // pg_dump query pattern: // SELECT t.tgname, pg_get_expr(t.tgqual, t.tgrelid, false) as when_clause // FROM pg_catalog.pg_trigger t WHERE ... // pgschema adaptation (in ir/inspector.go or ir/queries/): query := `SELECT t.tgname, pg_get_expr(t.tgqual, t.tgrelid, false) FROM pg_catalog.pg_trigger t WHERE t.tgrelid = $1 AND NOT t.tgisinternal` rows, err := conn.Query(ctx, query, tableOID) ```
© pgplex · Apache-2.0 · pgplex/pgschema