К основному содержанию
скилл CX Codex

416-frameworks-quarkus-mongodb-migrations-mongock — скилл для Quarkus

Скилл 416-frameworks-quarkus-mongodb-migrations-mongock для настройки и проверки миграций MongoDB в Quarkus через Mongock. Помогает добавлять @ChangeUnit классы, конфигурировать расширение quarkus-mongock и верифицировать порядок миграций.

Apache-2.0 212 установок ★ 465 обновлён 2026-10-21

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add jabrena/plinth --skill 416-frameworks-quarkus-mongodb-migrations-mongock -a claude-code
Открыть на GitHub

Что делает 416-frameworks-quarkus-mongodb-migrations-mongock

Скилл охватывает всю цепочку работы с Mongock в Quarkus: от подключения расширения Quarkiverse quarkus-mongock и конфигурации quarkus.mongock.* до написания идемпотентных @ChangeUnit миграций с хуками @Execution и откатом. Внутри есть правила по замкам, транзакциям и ограничениям для дефолтного клиента MongoDB.

Перед любым изменением скилл требует скомпилировать проект через ./mvnw compile или mvn compile, а после применений запустить ./mvnw clean verify или mvn clean verify. Если компиляция упадёт, скилл останавливается. Перед добавлением расширения он проверяет совместимость последнего релиза Quarkiverse Mongock с активной платформой Quarkus и версией MongoDB клиента.

Скилл учитывает координацию с @415-frameworks-quarkus-mongodb и граничные случаи вроде нескольких MongoDB клиентов в приложении.

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

  • добавить Mongock миграции в Quarkus приложение
  • настроить quarkus-mongock и запуск миграций при старте
  • создать и упорядочить @ChangeUnit классы с откатом
  • проверить идемпотентность миграций и безопасность замков
  • верифицировать миграции через Quarkus тесты с Dev Services

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

  • Добавь Mongock миграцию для изменения схемы коллекции users в Quarkus
  • Создай @ChangeUnit класс для исправления данных в orders с откатом
  • Проверь порядок миграций и совместимость quarkus-mongock с текущей платформой Quarkus

Как установить 416-frameworks-quarkus-mongodb-migrations-mongock

1Через Skills CLI (Vercel)

npx skills add jabrena/plinth --skill 416-frameworks-quarkus-mongodb-migrations-mongock -a claude-code

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

~/.claude/skills/416-frameworks-quarkus-mongodb-migrations-mongock/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/416-frameworks-quarkus-mongodb-migrations-mongock/

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

Вопросы о 416-frameworks-quarkus-mongodb-migrations-mongock

Как установить 416-frameworks-quarkus-mongodb-migrations-mongock в Claude Code?

Выполни npx skills add jabrena/plinth --skill 416-frameworks-quarkus-mongodb-migrations-mongock -a claude-code, затем открой ~/.claude/skills/416-frameworks-quarkus-mongodb-migrations-mongock/SKILL.md.

Что делает этот скилл?

Скилл помогает добавлять и проверять миграции MongoDB через Mongock в Quarkus: настраивает расширение, пишет @ChangeUnit классы, проверяет совместимость и верифицирует через тесты.

Какие проверки скилл делает перед изменениями?

Скилл требует скомпилировать проект перед любым изменением, проверяет совместимость Quarkiverse Mongock с активной версией Quarkus и обнаруживает конфликты с несколькими MongoDB клиентами.

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

SKILL.md · Apache-2.0
---
name: 416-frameworks-quarkus-mongodb-migrations-mongock
description: Use when you need to add or review Mongock MongoDB data migrations in a Quarkus application — including the Quarkiverse Mongock extension, Quarkus MongoDB client configuration, migrate-at-start, @ChangeUnit classes, lock/transaction settings, and Quarkus test verification. This should trigger for requests such as Add Mongock migrations in Quarkus; Configure quarkus-mongock; Review Quarkus MongoDB data migrations; Create Mongock change units for Quarkus MongoDB; Review Mongock migration ordering in a Quarkus service. Part of Plinth Toolkit
license: Apache-2.0
metadata:
  author: Juan Antonio Breña Moral
  version: 0.19.0
---
# Quarkus - MongoDB migrations (Mongock)

Apply Mongock migration guidelines for Quarkus and Quarkus MongoDB client/Panache Mongo.

**What is covered in this Skill?**

- Quarkiverse `quarkus-mongock` extension and Quarkus MongoDB client setup
- `quarkus.mongock.*` configuration, including `migrate-at-start`
- Code-first `@ChangeUnit` migrations with `@Execution` and rollback hooks
- Locking, idempotency, transaction limits, and default-client constraints
- Quarkus tests with Dev Services or Testcontainers MongoDB
- Coordination with `@415-frameworks-quarkus-mongodb`

**Scope:** Apply recommendations based on the reference rules and good/bad examples.

## Constraints

Compile before Mongock or MongoDB migration changes; verify after changes.

- **MANDATORY**: Run `./mvnw compile` or `mvn compile` before applying any change
- **SAFETY**: If compilation fails, stop immediately
- **VERIFY**: Run `./mvnw clean verify` or `mvn clean verify` after applying improvements
- **BEFORE APPLYING**: Read the reference for detailed rules and good/bad patterns
- **EXTENSION COMPATIBILITY**: Before adding `quarkus-mongock`, verify the latest Quarkiverse Mongock release and Quarkus extension catalog compatibility with the active Quarkus platform. If the latest extension targets a significantly older Quarkus version, stop and document the incompatibility instead of applying changes.
- **EDGE CASE**: If the application uses multiple MongoDB clients, verify Quarkiverse Mongock support before applying a default-client migration design

## When to use this skill

- Add Mongock migrations in Quarkus
- Configure quarkus-mongock
- Review Quarkus MongoDB data migrations
- Create Mongock change units for Quarkus MongoDB
- Review Mongock migration ordering in a Quarkus service

## Workflow

1. **Read references and inspect MongoDB setup**

Read `references/416-frameworks-quarkus-mongodb-migrations-mongock.md`, `references/416-frameworks-quarkus-mongodb-migrations-mongock-antipatterns.md`, and `references/416-frameworks-quarkus-mongodb-migrations-mongock-parallel-change.md`, then inspect `pom.xml`, Quarkus MongoDB configuration, and existing `@415-frameworks-quarkus-mongodb` persistence patterns.

2. **Verify extension compatibility and execution policy**

Verify the Quarkiverse `quarkus-mongock` release and Quarkus extension catalog compatibility before configuring MongoDB connection settings, migration scan behavior, and startup vs explicit `MongockFactory` execution.

3. **Apply framework-aligned migrations**

Implement/refactor `@ChangeUnit` classes with idempotent operations, explicit ordering, rollback hooks, and safe lock/transaction settings.

4. **Run verification and report results**

Execute build/tests, including Quarkus tests with Dev Services or Testcontainers MongoDB where feasible, and summarize outcomes and follow-up risks.

## Reference

For detailed guidance, examples, and constraints, see:

- [references/416-frameworks-quarkus-mongodb-migrations-mongock.md](references/416-frameworks-quarkus-mongodb-migrations-mongock.md)
- [references/416-frameworks-quarkus-mongodb-migrations-mongock-antipatterns.md](references/416-frameworks-quarkus-mongodb-migrations-mongock-antipatterns.md)
- [references/416-frameworks-quarkus-mongodb-migrations-mongock-parallel-change.md](references/416-frameworks-quarkus-mongodb-migrations-mongock-parallel-change.md)

© Juan Antonio Breña Moral · Apache-2.0 · jabrena/plinth

Похожие скиллы

Все скиллы по теме «Бэкенд и API» →
prisma-mongodb-upgrade prisma Скилл prisma-mongodb-upgrade помогает спланировать переход проектов на Prisma ORM с MongoDB с версии 6 сразу на 8 либо обоснованно остаться на v6 из-за отсутствия коннектора в Prisma 7. CX Codex +1 419 000установок mongodb-query-optimizer mongodb Скилл mongodb-query-optimizer для Claude Code и Codex, анализирует медленные запросы MongoDB и подбирает индексы. Запускается когда вы спрашиваете, почему запрос медленный или как его ускорить. CX Codex +1 7 700установок mongodb-connection mongodb Скилл mongodb-connection помогает агенту подобрать параметры пула и таймаутов MongoDB под вашу нагрузку, а не копировать чужие значения. CX Codex +1 5 700установок mongodb hoodini Скилл для работы с MongoDB и Mongoose: помогает проектировать схемы, писать запросы и агрегации, разбираться с индексами. CX Codex +1 1 700установок mongodb-development Mindrally Скилл mongodb-development для Claude Code задаёт правила разработки на MongoDB: схемы, индексы, агрегации, Mongoose и Payload CMS. Описывает работу агента над бэкендом на TypeScript. CX Codex +1 935установок mongoose-mongodb pluginagentmarketplace Скилл mongoose-mongodb помогает подключать MongoDB к Node.js через Mongoose: описывать схемы, выполнять CRUD-запросы и строить сложные выборки. CX Codex +1 702установок

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

Весь набор →
808-regulations-eu-digital-markets-act Скилл 808-regulations-eu-digital-markets-act помогает проверять корпоративные Java-системы на соответствие требованиям закона ЕС о цифровых рынках (DMA). CX Codex +1 213установок 802-regulations-dora Скилл 802-regulations-dora проверяет Java-системы на готовность к DORA: ICT-риски, инциденты, резервное копирование, сторонних провайдеров — до выхода в прод. CX Codex +1 213установок 803-regulations-gdpr Скилл 803-regulations-gdpr проверяет Java-сервисы на соответствие GDPR и помогает спроектировать инженерные контроли защиты персональных данных до релиза в прод. CX Codex +1 213установок 516-frameworks-micronaut-mongodb-migrations-mongock Скилл 516-frameworks-micronaut-mongodb-migrations-mongock для Claude Code помогает настраивать и проверять миграции MongoDB через Mongock в Micronaut. Охватывает runner, миграции и интеграционные тесты. CX Codex +1 213установок 801-regulations-eu-ai-act Скилл 801-regulations-eu-ai-act помогает внедрить инженерные контроли EU AI Act в корпоративные Java-приложения на базе LLM, RAG и агентов. Пригодится при подготовке AI-систем к аудиту и релизу. CX Codex +1 212установок 805-regulations-eu-cyber-resilience-act Скилл 805-regulations-eu-cyber-resilience-act помогает проверять Java-продукты и связанные компоненты на инженерные требования EU Cyber Resilience Act. Пригодится перед изменением или выпуском продукта с цифровыми элементами. CX Codex +1 212установок 806-regulations-eu-data-act Скилл 806-regulations-eu-data-act разбирает Java-сервисы, API и пайплайны на инженерные контроли EU Data Act: доступ к данным, экспорт, переносимость, переход между облаками. Полезен до релиза функции обмена данными. CX Codex +1 212установок 500-frameworks-micronaut-create-project Скилл 500-frameworks-micronaut-create-project создаёт Maven-проект на Micronaut 4.x через SDKMAN и Micronaut CLI. Он пригодится, когда нужно подготовить новый сервис и проверить сборку. CX Codex +1 211установок

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

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