К основному содержанию
субагент CX Codex

postgres-pro · voltagent/awesome-codex-subagents — субагент для Codex: задачи и установка

Субагент postgres-pro для Codex разбирает схемы PostgreSQL, планы запросов, блокировки и эксплуатационные риски. Он подключается к задачам, где нужны рекомендации с учётом нагрузки и миграций.

MIT ★ 6 505 обновлён 2026-10-05

Установить в Codex · Вручную: положить файлы Все способы и платформы ↓
.codex/agents/postgres-pro.toml
Открыть на GitHub

Что делает postgres-pro

postgres-pro анализирует PostgreSQL-запросы с учётом формы таблиц и индексов, транзакций и поведения планировщика. Он ищет источник проблемы — например, неудачный выбор плана, нехватку индекса или конкуренцию за блокировки — и предлагает небольшое безопасное изменение с оценкой отката.

Субагент рассматривает изоляцию транзакций, типы индексов, миграции больших таблиц, vacuum и autovacuum, секционирование, репликацию и отказоустойчивость. Рекомендации проверяются для обычного сценария и пути с высокой конкуренцией; отдельно отмечаются проверки, которые нужны в production. Рискованные изменения схемы и операции обслуживания он не советует без доказательств и безопасного плана выката, если родительский агент прямо их не запросил.

Какие задачи решает

  • найти причину медленного PostgreSQL-запроса
  • оценить блокировки и риск взаимной блокировки
  • подобрать индекс под реальные шаблоны доступа
  • спланировать миграцию большой таблицы с откатом
  • проверить влияние изменений на репликацию и доступность

Примеры запросов агенту

  • Разбери медленный запрос к PostgreSQL и объясни, что мешает планировщику.
  • Оцени блокировки и риск взаимной блокировки в этой транзакции.
  • Составь безопасный план миграции большой таблицы с откатом.

Как установить postgres-pro

Вручную: положить файлы

.codex/agents/postgres-pro.toml

Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст

Вопросы о postgres-pro

Как установить postgres-pro в Codex?

Добавь файл субагента по пути .codex/agents/postgres-pro.toml.

Что делает postgres-pro?

Анализирует схемы PostgreSQL, запросы, индексы, блокировки и риски миграций. Предлагает небольшие изменения и описывает проверки, откат и остаточные риски.

Какие задачи PostgreSQL разбирает postgres-pro?

Он рассматривает поведение планировщика, конкуренцию за блокировки, изоляцию транзакций, миграции больших таблиц, обслуживание, секционирование и репликацию.

Исходный текст

postgres-pro.toml · MIT
# postgres-pro

Use when a task needs PostgreSQL-specific expertise for schema design, performance behavior, locking, or operational database features.

Own PostgreSQL review as planner-aware performance and operational safety analysis.

Ground recommendations in workload behavior, locking semantics, and migration risk rather than generic tuning rules.

Working mode:
1. Map the Postgres boundary: query pattern, table/index shape, and transaction behavior.
2. Identify dominant issue source (planner choice, index gaps, lock contention, or schema design constraint).
3. Recommend the smallest safe improvement with clear rollback implications.
4. Validate expected impact for one normal path and one high-contention or degraded path.

Focus on:
- planner behavior with statistics, cardinality, and index selectivity
- lock modes, transaction isolation, and deadlock/contention risk
- index design including btree/gin/gist/brin suitability tradeoffs
- schema evolution and migration/backfill safety on large tables
- vacuum/analyze/autovacuum implications for long-term performance
- partitioning and retention strategies where workload scale justifies it
- replication and failover considerations for operational safety

Quality checks:
- verify query/index recommendations align with observed access patterns
- confirm lock and isolation implications are explicit for write-heavy paths
- check migration guidance for downtime, rollback, and replication impact
- ensure planner/statistics assumptions are called out where uncertain
- call out production-level validations needed beyond static code review

Return:
- primary PostgreSQL issue and mechanism behind it
- smallest high-leverage change with tradeoffs
- expected impact on latency/throughput/operability
- validations performed and remaining environment checks
- residual risk and phased next steps

Do not recommend risky schema rewrites or maintenance operations without evidence and rollout safety unless explicitly requested by the parent agent.

© VoltAgent · MIT · VoltAgent/awesome-codex-subagents

Похожие субагенты

Все субагенты по теме «Бэкенд и API» →

Сначала — postgres-pro от других авторов.

postgres-pro VoltAgent Community Субагент postgres-pro для настройки PostgreSQL, разбора медленных запросов, репликации и резервного копирования. Нужен при проблемах с производительностью и отказоустойчивостью базы. CX Codex 897установок design-postgres-tables tigerdata Скилл design-postgres-tables для Claude Code проектирует таблицы PostgreSQL: типы данных, индексы, ограничения, JSONB и партиционирование. Включается при создании или изменении схемы. CX Codex +1 680установок postgres-tuning oakoss Скилл postgres-tuning для Claude Code, Codex, Cursor и других агентов, который даёт инструкции по настройке производительности PostgreSQL 17/18+. Охватывает async I/O, анализ планов запросов, индексы, autovacuum, pgvector и PgBouncer. CX Codex +1 136установок postgres-expert 0xfurai Субагент postgres-expert помогает проектировать схемы PostgreSQL, оптимизировать медленные SQL-запросы и настраивать индексы под рабочую нагрузку. CX Codex ★ 1 029звёзд репо postgres-query civitai Скилл postgres-query выполняет SQL-запросы к PostgreSQL, запускает EXPLAIN ANALYZE и проверяет индексы через агент в безопасном режиме чтения. CX Codex +1 ★ 7 327звёзд репо postgresql davila7 Помогает спроектировать схему таблиц под PostgreSQL с расчётом на надёжные типы данных, ограничения целостности и особенности движка. CX Codex +1 312установок database-designer borghei Скилл database-designer для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode проверяет SQL-схемы, подбирает индексы и создаёт миграции. Используйте его при ревью DDL, настройке индексов или сравнении версий схемы. CX Codex +1 176установок

Из того же набора176

Весь набор →
cli-developer Субагент cli-developer для Codex, который берёт разработку интерфейсов командной строки как инженерию, а не чек-лист. CX Codex ★ 6 505звёзд репо build-engineer Субагент build-engineer для диагностики проблем в графе зависимостей, исправления ошибок сборки и стабилизации CI-конвейера. Помогает найти корень проблемы, не переделывая всю систему сборки. CX Codex ★ 6 505звёзд репо reinforcement-learning-engineer Субагент reinforcement-learning-engineer проектирует среды обучения с подкреплением, настраивает функции вознаграждения и оценивает политики агентов в Codex. CX Codex ★ 6 505звёзд репо prompt-engineer Субагент prompt-engineer разбирает промпты как контракты: находит неоднозначности, уточняет формат ответа и предлагает проверку на обычных, крайних и ошибочных сценариях. CX Codex ★ 6 505звёзд репо nlp-engineer Субагент nlp-engineer помогает настраивать пайплайны обработки текста, токенизацию, эмбеддинги и ранжирование в Codex. Фокусируется на сбоях в реальных запросах. CX Codex ★ 6 505звёзд репо mlops-engineer Субагент mlops-engineer для Codex ведёт задачи по развёртыванию моделей, реестрам, пайплайнам и мониторингу. Контролирует выпуск и откат ML-систем. CX Codex ★ 6 505звёзд репо ml-engineer Субагент ml-engineer для работы с машинным обучением в production-коде: от подготовки признаков до проверки контрактов на границах inference. Помогает держать ML-логику стабильной и видимой в user-facing поведении. CX Codex ★ 6 505звёзд репо machine-learning-engineer Субагент machine-learning-engineer настраивает надёжный инференс и устраняет расхождения между обучением и продакшеном. CX Codex ★ 6 505звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой