# 413-frameworks-quarkus-db-migrations-flyway

Скилл для ИИ-агента, который добавляет и проверяет миграции Flyway в приложении на Quarkus: расширение quarkus-flyway, SQL-скрипты, настройки и порядок применения.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 313 установок · ★ 456
- Автор: Juan Antonio Breña Moral
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/jabrena/plinth/tree/HEAD/skills/413-frameworks-quarkus-db-migrations-flyway/SKILL.md
- Обновлён: 2026-10-21
- HTML: https://affpapa.org/nevibecode/skills/413-frameworks-quarkus-db-migrations-flyway

## Что делает

Скилл ведёт агента по работе с миграциями базы в Quarkus. Он подключает `quarkus-flyway` вместе с драйверами `quarkus-jdbc-*`, раскладывает версионные SQL-файлы в `src/main/resources/db/migration` и настраивает параметры вида `quarkus.flyway.migrate-at-start`, locations и baseline. Отдельно разбирается случай нескольких datasources.

Внутри три справочника: основной файл с правилами и примерами «как надо / как не надо», список антипаттернов и описание Parallel Change — схемы expand, migrate, contract для ломающих или чувствительных к данным изменений схемы. Скилл согласуется с соседними `@411-frameworks-quarkus-jdbc` и `@412-frameworks-quarkus-panache`, поэтому миграции не расходятся с кодом доступа к данным.

Перед правками агент обязан прогнать `./mvnw compile` или `mvn compile` и остановиться, если сборка упала; после — `./mvnw clean verify`. Если миграция может сломать уже развёрнутые версии приложения, зависимые сервисы, отчёты или задания, скилл требует явного решения человека. Это стоит держать в голове: агент не станет молча применять рискованное изменение, а спросит.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add jabrena/plinth --skill 413-frameworks-quarkus-db-migrations-flyway -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add jabrena/plinth --skill 413-frameworks-quarkus-db-migrations-flyway -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add jabrena/plinth --skill 413-frameworks-quarkus-db-migrations-flyway -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install jabrena/plinth 413-frameworks-quarkus-db-migrations-flyway
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/413-frameworks-quarkus-db-migrations-flyway/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add jabrena/plinth --skill 413-frameworks-quarkus-db-migrations-flyway -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/jabrena/plinth --path skills/413-frameworks-quarkus-db-migrations-flyway
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add jabrena/plinth --skill 413-frameworks-quarkus-db-migrations-flyway -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/jabrena/plinth/tree/HEAD/skills/413-frameworks-quarkus-db-migrations-flyway/SKILL.md

## Когда брать
- добавить версионную SQL-миграцию в проект на Quarkus
- настроить `quarkus-flyway` и каталог `db/migration`
- проверить порядок применения миграций и baseline
- разложить миграции по нескольким datasources
- провести ломающее изменение схемы через expand, migrate, contract

## Примеры запросов агенту
- Добавь миграцию Flyway для новой таблицы заказов в Quarkus-проекте
- Проверь порядок миграций в `src/main/resources/db/migration` и настройки `quarkus.flyway.migrate-at-start`
- Разложи миграции Flyway по двум datasources и проверь baseline

## Похожие
- [sql-migrations](https://affpapa.org/nevibecode/commands/sql-migrations.md) — команда · ★ 41729
- [quarkus](https://affpapa.org/nevibecode/skills/quarkus.md) — скилл · 1000 установок
- [quarkus-native-and-container](https://affpapa.org/nevibecode/skills/quarkus-native-and-container.md) — скилл · ★ 40418
- [java-coding-standards](https://affpapa.org/nevibecode/skills/java-coding-standards.md) — скилл · 5100 установок
- [graalvm-native-image](https://affpapa.org/nevibecode/skills/graalvm-native-image.md) — скилл · 3500 установок
- [java](https://affpapa.org/nevibecode/skills/java.md) — скилл · 966 установок

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

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

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