drizzle-safe-migrations — скилл безопасных миграций Drizzle для Claude Code
Скилл drizzle-safe-migrations для Claude Code: планирует безопасные миграции Drizzle — бэкфиллы, ужесточение enum/check/default, порядок шагов и откат. Срабатывает при смене схемы, затрагивающей существующие строки.
лицензия не указана 348 установок ★ 655 обновлён 2026-10-20
npx skills add pedronauck/skills --skill drizzle-safe-migrations -a claude-codeЧто делает drizzle-safe-migrations
Скилл задаёт правила для миграций через Drizzle: генерировать схему только скриптом проекта, не трогать сгенерированные файлы руками, а бэкфиллы данных делать отдельными кастомными миграциями. Сначала — нормализация данных, потом — ужесточение ограничений.
Порядок работы такой: классифицировать изменение (только схема или схема плюс данные), для данных создать кастомную миграцию через bun run db:generate -- --custom --name <name>, затем сгенерировать схему обычным bun run db:generate. После этого проверяется порядок в drizzle/meta/_journal.json: бэкфилл должен идти раньше, чем ужесточение ограничений. В конце — прогнать миграции на базе с существующими данными и на чистой установке, записать риски блокировок и стратегию отката.
Есть отсылка к references/production-playbook.md с шаблонами команд и чек-листами для ревью. Для PostgreSQL при жёстких требованиях к аптайму советует рассмотреть staged-валидацию через NOT VALID / VALIDATE CONSTRAINT, но она работает не для всех видов ограничений. Анти-паттерны прописаны прямо: не править сгенерированные файлы, не ужесточать ограничения до бэкфилла, не прятать разовую логику в коде запуска приложения.
Какие задачи решает
- спланировать бэкфилл данных перед ужесточением ограничений
- проверить порядок миграций в журнале Drizzle
- сделать идемпотентные UPDATE с узкими WHERE
- прогнать миграции на базе с данными и на чистой установке
- записать риски блокировок и шаги отката
Примеры запросов агенту
- Спланируй миграцию, которая убирает значение
legacy_valueиз enum у таблицы заказов - Проверь порядок бэкфилла и ужесточения ограничений в
drizzle/meta/_journal.json - Создай кастомную миграцию для нормализации старых строк перед сменой дефолта
Как установить drizzle-safe-migrations
1Через Skills CLI (Vercel)
npx skills add pedronauck/skills --skill drizzle-safe-migrations -a claude-code2Вручную: положить файлы
~/.claude/skills/drizzle-safe-migrations/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/drizzle-safe-migrations/
1Через Skills CLI (Vercel)
npx skills add pedronauck/skills --skill drizzle-safe-migrations -a codex2Вручную: положить файлы
.agents/skills/drizzle-safe-migrations/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add pedronauck/skills --skill drizzle-safe-migrations -a cursor2Вручную: положить файлы
.cursor/skills/drizzle-safe-migrations/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install pedronauck/skills skills/mine/drizzle-safe-migrations2Вручную: положить файлы
.github/skills/drizzle-safe-migrations/SKILL.md1Через Skills CLI (Vercel)
npx skills add pedronauck/skills --skill drizzle-safe-migrations -a gemini-cli2Командой платформы
gemini skills install https://github.com/pedronauck/skills --path skills/mine/drizzle-safe-migrationsВручную: положить файлы
.devin/skills/drizzle-safe-migrations/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add pedronauck/skills --skill drizzle-safe-migrations -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о drizzle-safe-migrations
Как установить drizzle-safe-migrations в Claude Code?
Выполни npx skills add pedronauck/skills --skill drizzle-safe-migrations -a claude-code. Скилл появится в ~/.claude/skills/drizzle-safe-migrations/SKILL.md.
Что делает drizzle-safe-migrations?
Задаёт порядок безопасных миграций Drizzle: сначала бэкфилл данных кастомной миграцией, потом генерация схемы и ужесточение ограничений. Проверяет очерёдность в журнале и требует прогнать миграции на базе с данными и на чистой установке.
Чем отличается кастомная миграция от схемной?
Схемную миграцию генерирует скрипт проекта, и её нельзя редактировать вручную. Кастомную создают через bun run db:generate -- --custom --name <name> и правят только её SQL — туда кладут бэкфиллы данных.