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

doctrine-migrations — скилл для Claude Code: миграции Doctrine

Скилл doctrine-migrations помогает создавать и проверять миграции Doctrine, откатывать версии и готовить их к запуску в production. Пригодится при изменениях схемы Symfony-приложения.

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

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add dev-toolings/superpowers-symfony --skill doctrine-migrations -a claude-code
Открыть на GitHub

Что делает doctrine-migrations

Скилл ведёт по рабочему циклу миграции: после изменения маппинга предлагает создать файл через make:migration или doctrine:migrations:diff, проверить SQL и убедиться, что down() действительно отменяет up(). Отдельно напоминает проверять статус и запускать пробный прогон перед применением миграции.

Он также описывает откат через doctrine:migrations:migrate prev или doctrine:migrations:execute --down, а при нескольких entity manager — передачу --em каждой команде. Уже применённую миграцию менять нельзя: для исправления нужна новая. Изменения данных следует отделять от изменений схемы; миграции, созданные из diff, должны менять только схему.

Для PostgreSQL настройка all_or_nothing в основном эффективна; большинство DDL-команд MySQL фиксируются неявно. Поэтому на MySQL нельзя рассчитывать на такой же откат всей группы операций. Скилл ограничен рекомендациями и работой с файлами миграций: он не заменяет проверку SQL перед запуском в production.

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

  • создать миграцию после изменения маппинга сущности
  • проверить SQL в сгенерированной миграции
  • написать откат, обратный методу up()
  • проверить ожидающие миграции перед применением
  • откатить версию или подготовить миграции к production

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

  • Создай миграцию Doctrine после добавления поля в маппинг сущности.
  • Проверь файл миграции: найди рискованную замену столбца и проверь, что down() отменяет up().
  • Покажи статус миграций, выполни пробный запуск и подготовь команду отката для production.

Как установить doctrine-migrations

1Через Skills CLI (Vercel)

npx skills add dev-toolings/superpowers-symfony --skill doctrine-migrations -a claude-code

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

~/.claude/skills/doctrine-migrations/SKILL.md

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

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

Вопросы о doctrine-migrations

Как установить doctrine-migrations в Claude Code?

Выполни npx skills add dev-toolings/superpowers-symfony --skill doctrine-migrations -a claude-code. Файл скилла находится по пути ~/.claude/skills/doctrine-migrations/SKILL.md.

Что делает скилл doctrine-migrations?

Помогает создавать миграции Doctrine из изменений маппинга, проверять SQL и готовить откаты. Также описывает проверку статуса и пробный запуск перед применением.

Как скилл учитывает несколько entity manager и MySQL?

Для нескольких entity manager он рекомендует передавать --em каждой команде миграций. Настройка all_or_nothing в основном эффективна на PostgreSQL, поскольку DDL-команды MySQL часто фиксируются неявно.

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

SKILL.md · MIT
---
name: doctrine-migrations
description: Create and manage Doctrine migrations (bundle 4.x, library 3.9) for schema versioning; handle dependencies, rollbacks, and production deployment
capabilities: [read, search, edit, shell]
tags: [doctrine]
# projected by `bun run build` — do not edit by hand
allowed-tools:
  - Read
  - Glob
  - Grep
  - Write
  - Edit
  - Bash
---

# Doctrine Migrations (Symfony)

## Use when
- A mapping change needs a schema migration (new column, index or table).
- Reviewing a generated `make:migration` or `doctrine:migrations:diff` file before it is applied.
- Rolling back a version, or deploying pending migrations to production.
- Tuning `doctrine_migrations.yaml` (`transactional`, `all_or_nothing`, `enable_service_migrations`).

## Default workflow
1. Change the entity mapping, then generate the migration with `make:migration` or `doctrine:migrations:diff`.
2. Read every `addSql()` line: a rename can appear as drop plus add, and index churn is common.
3. Write a real `down()` that reverses `up()`, and keep one concern per migration.
4. Check `doctrine:migrations:status`, preview with `doctrine:migrations:migrate --dry-run`, then run `doctrine:migrations:migrate`.
5. Roll back with `doctrine:migrations:migrate prev` or `doctrine:migrations:execute` with `--down`.
6. With several entity managers, pass `--em` to every migrations command.

## Guardrails
- Never edit an already-applied migration: add a new one.
- Keep diff-generated migrations schema only; put data changes in a dedicated, idempotent migration or command.
- Keep the typed signatures `up(Schema $schema): void` and `down(Schema $schema): void`.
- `all_or_nothing` is mostly effective on PostgreSQL, since most MySQL DDL commits implicitly.

## Progressive disclosure
- Use this file for execution posture and risk controls.
- Open references when deep implementation details are needed.

## Output contract
- Migration files with a reviewed `up()` and a working `down()`.
- Output of `doctrine:migrations:status` and the dry-run, plus the rollback command.
- Any `doctrine_migrations.yaml` change and why.

## References
- `reference.md`

© dev-toolings · MIT · dev-toolings/superpowers-symfony

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

Все скиллы по теме «Данные и базы» →
database-migrations affaan-m Скилл database-migrations для Claude Code помогает писать миграции схемы и данных, планировать откат и готовить изменения без простоя. Включается при добавлении столбца или индекса в большую таблицу. CX Codex +1 7 200установок managed-airflow-migrations официальный google Скилл managed-airflow-migrations помогает подготовить DAG для Managed Service for Apache Airflow к Airflow 2.11.1 или Airflow 3. Пригодится при обновлении версии, а не при разборе ошибок запусков. CX Codex +1 4 200установок convex-migrations waynesutton Скилл convex-migrations для Claude Code. Проводит изменение схемы Convex за шесть шагов: сделать поле необязательным, залить данные батчами, переключить валидатор, подчистить. Решает падение npx convex dev на существующих документах. CX Codex +1 2 600установок drizzle-migrations bobmatnyc Скилл drizzle-migrations для Claude Code задаёт порядок работы с базой в TypeScript: сначала SQL-миграция, потом схема. Миграции становятся источником правды в нескольких окружениях. CX Codex +1 1 300установок 313-frameworks-spring-db-migrations-flyway Juan Antonio Breña Moral Скилл 313-frameworks-spring-db-migrations-flyway для работы с миграциями Flyway в Spring Boot: зависимости Maven, скрипты в db/migration, настройки spring.flyway.* и порядок применения. CX Codex +1 389установок drizzle-safe-migrations Pedro Nauck Скилл drizzle-safe-migrations для Claude Code: планирует безопасные миграции Drizzle — бэкфиллы, ужесточение enum/check/default, порядок шагов и откат. Срабатывает при смене схемы, затрагивающей существующие строки. CX Codex +1 348установок

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

Весь набор →
symfony-scheduler Настраивает периодические задачи через Symfony Scheduler без системного cron. Запускает генерацию отчётов, очистку данных и синхронизации через Symfony Messenger. CX Codex +1 ★ 234звёзд репо tdd-with-pest Скилл tdd-with-pest для Claude Code ведёт разработку в Symfony через RED-GREEN-REFACTOR с Pest v4. Создаёт тесты, воспроизводит баги и переносит PHPUnit-тесты на синтаксис Pest. CX Codex +1 ★ 234звёзд репо api-platform-versioning Скилл api-platform-versioning помогает менять API на API Platform без ломающих релизов: сначала депрекация с датой sunset, параллельные версии — в крайнем случае. CX Codex +1 ★ 234звёзд репо functional-tests Скилл functional-tests помогает писать функциональные тесты контроллеров и сервисов Symfony на базе WebTestCase, KernelTestCase и DAMA rollback. CX Codex +1 ★ 234звёзд репо symfony-messenger Скилл для работы с асинхронными сообщениями через Symfony Messenger: настройка транспортов, обработчиков и стратегий повтора. CX Codex +1 ★ 234звёзд репо api-platform-security Скилл api-platform-security настраивает правила доступа в Symfony API Platform через выражения security, воутеры и хуки жизненного цикла операций. CX Codex +1 ★ 234звёзд репо e2e-panther-playwright Скилл e2e-panther-playwright для Claude Code помогает писать E2E-тесты Symfony: Panther запускает реальный браузер, Playwright берёт сложные сценарии. Тесты проверяют поведение JavaScript, невидимое WebTestCase. CX Codex +1 ★ 234звёзд репо doctrine-relations Скилл doctrine-relations помогает настроить связи между сущностями Doctrine (OneToMany, ManyToMany, ManyToOne) с правильным выбором сторон, каскадными операциями и защитой от N+1 запросов. CX Codex +1 ★ 234звёзд репо

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

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