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

316-frameworks-spring-mongodb-migrations-mongock

Скилл 316-frameworks-spring-mongodb-migrations-mongock для Claude Code добавляет и проверяет миграции Mongock в приложениях Spring Boot. Он включается при настройке или ревью миграций MongoDB.

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

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

Что делает 316-frameworks-spring-mongodb-migrations-mongock

Скилл настраивает Mongock для Spring Boot и Spring Data MongoDB: подбирает координаты зависимостей и драйвер, задаёт пакет сканирования миграций и правила запуска. Он помогает создавать классы @ChangeUnit с явным порядком, идемпотентными операциями и хуками отката, а также настраивать блокировки и транзакции.

Перед изменениями скилл требует выполнить ./mvnw compile или mvn compile; если компиляция падает, работу нужно остановить. После правок запускаются ./mvnw clean verify или mvn clean verify. Проверки с MongoDB допустимы только при разрешённом тестовом окружении; Docker-образ должен быть закреплён, одобрен политикой или уже подключён в проекте. Если версии Spring Data MongoDB и драйвера Mongock несовместимы, скилл останавливается и запрашивает решение.

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

  • добавить Mongock в приложение Spring Boot
  • настроить сканирование пакета миграций
  • создать @ChangeUnit с порядком и откатом
  • проверить совместимость драйвера Mongock с Spring Data MongoDB
  • проверить миграции и сборку проекта

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

  • Добавь миграции Mongock в приложение Spring Boot.
  • Проверь порядок миграций MongoDB и настройки блокировок.
  • Создай @ChangeUnit для Spring Data MongoDB с откатом.

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

1Через Skills CLI (Vercel)

npx skills add jabrena/plinth --skill 316-frameworks-spring-mongodb-migrations-mongock -a claude-code

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

~/.claude/skills/316-frameworks-spring-mongodb-migrations-mongock/SKILL.md

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

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

Вопросы о 316-frameworks-spring-mongodb-migrations-mongock

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

Выполни npx skills add jabrena/plinth --skill 316-frameworks-spring-mongodb-migrations-mongock -a claude-code. Файл скилла находится по пути ~/.claude/skills/316-frameworks-spring-mongodb-migrations-mongock/SKILL.md.

Что делает 316-frameworks-spring-mongodb-migrations-mongock?

Скилл помогает добавлять и проверять миграции Mongock для Spring Boot и Spring Data MongoDB. Он настраивает зависимости, пакет сканирования, классы @ChangeUnit, порядок выполнения и правила блокировок и транзакций.

Что нужно для проверки миграций MongoDB?

Нужно уже настроенное в проекте одобренное тестовое окружение MongoDB либо явное разрешение на закреплённый Docker-образ. Без успешной компиляции скилл прекращает работу.

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

SKILL.md · Apache-2.0
---
name: 316-frameworks-spring-mongodb-migrations-mongock
description: Use when you need to add or review Mongock MongoDB data migrations in a Spring Boot application — including Maven coordinates, Spring Data MongoDB drivers, migration scan packages, @ChangeUnit classes, lock/transaction settings, and optional policy-approved MongoDB integration verification. This should trigger for requests such as Add Mongock migrations in Spring Boot; Review Spring MongoDB data migrations; Configure Mongock change units for Spring Data MongoDB; Create Mongock change units for Spring Boot MongoDB; Review Mongock migration ordering in a Spring service. Part of Plinth Toolkit
license: Apache-2.0
metadata:
  author: Juan Antonio Breña Moral
  version: 0.19.0
---
# Spring - MongoDB migrations (Mongock)

Apply Mongock migration guidelines for Spring Boot and Spring Data MongoDB.

**What is covered in this Skill?**

- Mongock BOM, Spring Boot runner, and Spring Data MongoDB driver coordinates
- `mongock.migration-scan-package` configuration and startup execution
- Code-first `@ChangeUnit` migrations with `@Execution` and rollback hooks
- Locking, idempotency, transaction limits, and forward-only rollout discipline
- Optional MongoDB-backed integration tests using only project-approved, pinned, or already-available container images when the user permits external runtime dependencies
- Coordination with `@315-frameworks-spring-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
- **EDGE CASE**: If the project Spring Data MongoDB version is not compatible with the selected Mongock driver, stop and ask whether to pin/upgrade Mongock or use a lower driver generation
- **EXTERNAL RUNTIME GATE**: Do not pull or execute Docker images for MongoDB verification unless the user explicitly approves and the image is pinned, policy-approved, or already present in the project configuration

## When to use this skill

- Add Mongock migrations in Spring Boot
- Review Spring MongoDB data migrations
- Configure Mongock change units for Spring Data MongoDB
- Create Mongock change units for Spring Boot MongoDB
- Review Mongock migration ordering in a Spring service

## Workflow

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

Read `references/316-frameworks-spring-mongodb-migrations-mongock.md`, `references/316-frameworks-spring-mongodb-migrations-mongock-antipatterns.md`, and `references/316-frameworks-spring-mongodb-migrations-mongock-parallel-change.md`, then inspect `pom.xml`, Spring Boot version, dependency management, MongoDB configuration, existing full-context tests, and existing `@315-frameworks-spring-mongodb` persistence patterns.

2. **Choose runner, driver, and execution policy**

Select Mongock coordinates compatible with the active Spring Data MongoDB generation, configure migration scan packages, and decide startup vs controlled-job 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. Run MongoDB-backed migration checks only when the project already defines an approved MongoDB test runtime or the user explicitly approves a pinned container image. If generic `@SpringBootTest` smoke tests do not provide MongoDB, disable Mongock only for those tests with `mongock.enabled=false`. Summarize outcomes and follow-up risks.

## Reference

For detailed guidance, examples, and constraints, see:

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

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

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

Все скиллы по теме «Бэкенд и API» →
create-spring-boot-java-project официальный github Скилл create-spring-boot-java-project разворачивает каркас приложения Spring Boot через start.spring.io с готовой конфигурацией базы данных, тестов и Docker. Запускается при запросе на генерацию нового сервиса на Java. CX Codex +1 9 516установок prisma-mongodb-upgrade prisma Скилл prisma-mongodb-upgrade помогает спланировать переход проектов на Prisma ORM с MongoDB с версии 6 сразу на 8 либо обоснованно остаться на v6 из-за отсутствия коннектора в Prisma 7. CX Codex +1 419 000установок create-spring-boot-kotlin-project официальный github Скилл create-spring-boot-kotlin-project для GitHub Copilot, который разворачивает каркас Spring Boot-проекта на Kotlin. Скачивает шаблон со start.spring.io, добавляет зависимости и конфигурацию для Redis, PostgreSQL и MongoDB. CX Codex +1 8 700установок spring-boot-project-creator giuseppe-trisciuoglio Скилл spring-boot-project-creator для Claude Code автоматизирует создание проектов Spring Boot 3.x/4.x через Spring Initializr с выбором архитектуры DDD или слоистой, настройкой JPA, OpenAPI и сервисов Docker Compose. CX Codex +1 3 700установок 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установок

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

Весь набор →
004-commands-installation Скилл 004-commands-installation интерактивно переносит встроенные команды проекта из ресурсов Plinth Toolkit в выбранный каталог ассистента. CX Codex +1 219установок 005-agents-installation Скилл 005-agents-installation копирует встроенные определения субагентов в выбранный каталог проекта. Он пригодится, когда нужно подготовить .claude/agents или другую поддерживаемую папку. CX Codex +1 219установок 705-technologies-nosql-mongodb Скилл 705-technologies-nosql-mongodb для Claude Code охватывает MongoDB независимо от Spring Boot, Quarkus или Micronaut. Включается при работе со схемами документов, индексами, агрегациями и транзакциями. CX Codex +1 216установок 807-regulations-eu-digital-services-act Скилл 807-regulations-eu-digital-services-act помогает проверять Java-системы на инженерные контроли для DSA: модерацию, жалобы, рекомендации, рекламу и прозрачность. CX Codex +1 215установок 400-frameworks-quarkus-create-project Скилл 400-frameworks-quarkus-create-project для Claude Code создаёт Maven-проект на Quarkus 3.x через Quarkus CLI и инструменты SDKMAN. Создаёт проект нового сервиса с заданными координатами и расширениями. CX Codex +1 215установок 804-regulations-eu-nis2 Скилл 804-regulations-eu-nis2 для проверки Java-приложений на соответствие требованиям директивы NIS2 к киберустойчивости критически важных сервисов. Анализирует готовую инвентаризацию, не трогая код и логи. CX Codex +1 215установок 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установок

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

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