convex-migration-helper
Планирует и выполняет безопасные миграции схемы Convex с использованием widen-migrate-narrow и @convex-dev/migrations. Подходит для изменения схемы, миграции данных и развертывания без простоев.
AIget-convex
official
Разработка
★ 63
Что делает навык
Планирует и выполняет безопасные миграции схемы Convex с использованием паттерна widen-migrate-narrow и компонента @convex-dev/migrations. Позволяет изменять схему, мигрировать данные и развертывать обновления без простоев приложения.
Когда применять
- Добавление новых обязательных полей в существующие таблицы
- Изменение типов полей или структуры данных
- Разделение или объединение таблиц
- Переименование или удаление полей
- Миграция с вложенных данных на реляционные
Как работает
- Обновить схему, чтобы разрешить старый и новый форматы данных (widen)
- Обновить код для чтения обоих форматов и записи нового формата для новых документов
- Выполнить развертывание (Deploy 1) с расширенной схемой
- Запустить миграцию через компонент @convex-dev/migrations для обновления существующих документов
- Обновить схему, чтобы требовать только новый формат (narrow), и удалить код обработки старого формата
- Выполнить финальное развертывание (Deploy 2)
Примеры запросов агенту
Как безопасно добавить обязательное поле bio в таблицу users, не ломая существующие документы?
Планирование миграции для изменения типа поля с string на number с использованием @convex-dev/migrations
Как удалить устаревшее поле из схемы Convex без простоев и потери данных?
Что понадобится
- Установленный пакет @convex-dev/migrations
- Команда npx convex run migrations:<name> для запуска миграций
- Доступ к управлению схемой и кодом приложения Convex
Описание составлено по SKILL.md навыка, сверено 05.10.2026.
Как подключить
1Скачать навык
# возьмите папку навыка «convex-migration-helper» из репозитория:
# https://github.com/get-convex/agent-skills
2Положить папку с
SKILL.md к навыкам ассистента# положите папку навыка туда, где ассистент ищет skills:
cp -r convex-migration-helper/ ~/.claude/skills/convex-migration-helper/
Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.