# Neon Migration Specialist

Субагент для GitHub Copilot, который прогоняет миграции Postgres на ветках Neon и не трогает основную базу. Пригодится, когда схему надо менять без простоя.

- субагент · `type=agent` · GitHub Copilot · ★ 40451
- Автор: github · официальный репозиторий GitHub
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/github/awesome-copilot/tree/HEAD/agents/neon-migration-specialist.agent.md
- Обновлён: 2026-10-23
- HTML: https://affpapa.org/nevibecode/agents/neon-migration-specialist

## Что делает

Субагент работает с Neon Serverless Postgres и его ветками баз данных. Схема проверяется на отдельной ветке, созданной от main с TTL 4 часа через `expires_at` в формате RFC 3339, например `2025-07-15T18:02:16Z`. Миграции запускаются по строке подключения этой ветки, потом ветка удаляется. Файлы миграций агент готовит и открывает PR, а применение к main остаётся за вами или CI/CD.

Сначала понадобится ключ Neon API: если его нет, агент отправит вас в консоль Neon за ним. Ещё нужен ID проекта или строка подключения — новый проект агент не создаёт. Работа идёт через Neon API, `neonctl` не используется. Ветки баз данных и ветки git агент всегда называет с уточнением, чтобы не путать одно с другим.

Из инструментов миграций приоритет у того, что уже есть в проекте: Prisma, Drizzle, SQLAlchemy, Django ORM, Active Record, Hibernate. `migra` подключается только как запасной вариант, когда своей системы миграций нет, и ставить её поверх существующей не нужно. Новые markdown-файлы агент не создаёт — правит только те, что уже есть. Миграции на основной ветке базы не выполняются: это прямое ограничение, и обойти его нельзя.

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

## Установка

### GitHub Copilot (родная платформа)

**Вручную: положить файлы**
- Файл: `.github/agents/neon-migration-specialist.agent.md`

### Claude Code

**Вручную: положить файлы**
- Файл: `.claude/agents/neon-migration-specialist.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию. Поле tools у Copilot перечисляет инструменты по-своему — уберите его или перепишите под Claude Code

### Codex

**Вручную: положить файлы**
- Файл: `.codex/agents/neon-migration-specialist.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/agents/neon-migration-specialist.md` — Cursor понимает и .claude/agents/

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/github/awesome-copilot/tree/HEAD/agents/neon-migration-specialist.agent.md

## Когда брать
- проверить изменение схемы на копии базы, не рискуя продакшеном
- сгенерировать SQL миграции, когда в проекте нет своей системы миграций
- подготовить файлы миграций и открыть PR для CI/CD
- убрать тестовую ветку базы после проверки
- согласовать миграции с Prisma или Drizzle, уже принятыми в проекте

## Примеры запросов агенту
- Проверь миграцию добавления колонки `status` в таблицу `orders` на ветке Neon, потом удали её и открой PR
- Сгенерируй SQL для новой таблицы `invoices` через migra, своей системы миграций в проекте нет
- Прогони миграции Prisma на тестовой ветке Neon с TTL 4 часа и покажи результат

## Похожие
- [database-migrations](https://affpapa.org/nevibecode/skills/database-migrations.md) — скилл · 5200 установок
- [ai-engineer](https://affpapa.org/nevibecode/agents/ai-engineer.md) — субагент · 7687 установок
- [business-analyst](https://affpapa.org/nevibecode/agents/business-analyst.md) — субагент · 3855 установок
- [sql-pro](https://affpapa.org/nevibecode/agents/voltagent-community-sql-pro.md) — субагент · 3602 установки
- [sql-pro](https://affpapa.org/nevibecode/agents/sql-pro.md) — субагент · 3602 установки
- [data-scientist](https://affpapa.org/nevibecode/agents/voltagent-community-data-scientist.md) — субагент · 3342 установки
- [database-optimizer](https://affpapa.org/nevibecode/agents/database-optimizer.md) — субагент · 3320 установок

Из того же набора: [github/awesome-copilot](https://affpapa.org/nevibecode/by/github/awesome-copilot.md) — 949 карточек

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

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