doctrine-migrations — скилл для Claude Code: миграции Doctrine
Скилл doctrine-migrations помогает создавать и проверять миграции Doctrine, откатывать версии и готовить их к запуску в production. Пригодится при изменениях схемы Symfony-приложения.
MIT ★ 234 обновлён 2026-10-05
npx skills add dev-toolings/superpowers-symfony --skill doctrine-migrations -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/doctrine-migrations/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/doctrine-migrations/
1Через Skills CLI (Vercel)
npx skills add dev-toolings/superpowers-symfony --skill doctrine-migrations -a codex2Вручную: положить файлы
.agents/skills/doctrine-migrations/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add dev-toolings/superpowers-symfony --skill doctrine-migrations -a cursor2Вручную: положить файлы
.cursor/skills/doctrine-migrations/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install dev-toolings/superpowers-symfony content/skills/doctrine-migrations2Вручную: положить файлы
.github/skills/doctrine-migrations/SKILL.md1Через Skills CLI (Vercel)
npx skills add dev-toolings/superpowers-symfony --skill doctrine-migrations -a gemini-cli2Командой платформы
gemini skills install https://github.com/dev-toolings/superpowers-symfony --path content/skills/doctrine-migrationsВручную: положить файлы
.devin/skills/doctrine-migrations/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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