migration — скилл для Claude Code: что делает и как установить
Скилл задаёт правила безопасных миграций схем, данных и API с обязательным откатом. Пригодится при изменениях, где нельзя терять данные или ломать совместимость.
npx skills add JuliusBrussee/caveman --skill migration -a claude-codeЧто делает migration
Перед правками агент составляет карту читателей, писателей, формата данных и окна совместимости. Скилл требует планировать прямой путь и откат назад. Он запрещает неявные разрушительные действия. Удаление старых колонок или сжатие схемы разрешается только по отдельному подтверждению. Если раскатка версий перекрывается, агент сохраняет совместимость обеих версий.
Скилл выстраивает порядок шагов: расширение, перенос данных, проверка и только затем сужение. Повторные попытки должны быть идемпотентными. Агент обязан останавливаться сразу после запрошенного этапа, не запуская удаление данных сам. Ставить это стоит в проектах с живыми базами, а для пустых тестовых репозиториев регламент будет лишним.
Какие задачи решает
- запланировать откат перед изменением схемы базы
- изолировать разрушительные шаги миграции от подготовительных
- обеспечить работу смешанных версий сервиса во время выкатки
- проверить старый и новый путь передачи данных перед удалением старого
Примеры запросов агенту
- Спланируй миграцию таблицы users на новую схему с сохранением совместимости
- Подготовь обратимый переход для изменения контракта API заказов
- Проведи этап расширения базы без удаления устаревших колонок
Как установить migration
1Через Skills CLI (Vercel)
npx skills add JuliusBrussee/caveman --skill migration -a claude-code2Вручную: положить файлы
~/.claude/skills/migration/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/migration/
1Через Skills CLI (Vercel)
npx skills add JuliusBrussee/caveman --skill migration -a codex2Вручную: положить файлы
.agents/skills/migration/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add JuliusBrussee/caveman --skill migration -a cursor2Вручную: положить файлы
.cursor/skills/migration/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install JuliusBrussee/caveman migration2Вручную: положить файлы
.github/skills/migration/SKILL.md1Через Skills CLI (Vercel)
npx skills add JuliusBrussee/caveman --skill migration -a gemini-cli2Командой платформы
gemini skills install https://github.com/JuliusBrussee/caveman --path skills/migrationВручную: положить файлы
.devin/skills/migration/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add JuliusBrussee/caveman --skill migration -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
Из того же набора22
Весь набор →Похожие
Вопросы о migration
Как установить migration в Claude Code?
Выполните команду npx skills add JuliusBrussee/caveman --skill migration -a claude-code в терминале. Также можно сохранить файл по пути ~/.claude/skills/migration/SKILL.md.
Что делает скилл migration?
Он задаёт строгий протокол миграций для кода, баз данных, конфигураций и API. Ассистент сначала описывает читателей и писателей данных, готовит план отката и останавливается после каждого запрошенного шага.
Удалит ли агент старые данные автоматически?
Нет, скилл прямо запрещает неявное удаление и сжатие схем. Любые разрушительные операции требуют отдельного явного запроса.
Исходный текст
SKILL.md · Apache-2.0
--- name: migration description: Implement reversible compatibility-safe transitions. Use for schema, data, API, protocol, configuration, or dependency migrations requiring rollback and preservation proof. --- # Migration Map current readers, writers, data shape, compatibility window, and ownership before editing. - Define forward path and rollback path. - Preserve existing data; make destructive steps explicit and separately authorized. - Keep mixed-version operation safe where rollout can overlap. - Sequence expand, migrate, verify, then contract when applicable. - Make retries idempotent and partial failure observable. - Verify old and new paths at required transition stages. Stop after requested stage passes; do not perform later destructive contraction implicitly.
© JuliusBrussee · Apache-2.0 · JuliusBrussee/caveman