Навыки database-migrations-sql-migrations
📦

database-migrations-sql-migrations

Безопасно

Мастер SQL-миграций баз данных

Этот навык помогает разработчикам реализовать миграции баз данных с нулевым простоем для PostgreSQL, MySQL и SQL Server с встроенными процедурами отката и проверками валидации.

Поддерживает: Claude Codex Code(CC)
📊 70 Адекватно
1

Скачать ZIP навыка

2

Загрузить в Claude

Перейдите в Settings → Capabilities → Skills → Upload skill

3

Включите и начните использовать

Протестировать

Использование «database-migrations-sql-migrations». Создайте миграцию с нулевым простоем для добавления столбца status в таблицу orders

Ожидаемый результат:

  • Отчет о миграции
  • 1. Стратегия: П��ттерн Expand-Contract
  • 2. Фаза 1 (Expand): Добавление nullable столбца status
  • 3. Фаза 2 (Migrate): Заполнение status из столбца state пакетами
  • 4. Фаза 3 (Contract): Удаление старого столбца state после деплоя кода
  • 5. Валидация: Совпадение количества строк, отсутствие потери данных
  • 6. Откат: Возврат к снимку при ошибке валидации

Использование «database-migrations-sql-migrations». Напишите скрипт отката для миграции версии 001

Ожидаемый результат:

  • Скрипт отката для v001
  • - Проверка соответствия текущей версии
  • - Создание резервной копии перед откатом
  • - Выполнение миграции down.sql
  • - Удаление записи миграции
  • - Проверка успешности отката

Аудит безопасности

Безопасно
v1 • 2/24/2026

All 63 static findings are false positives. The skill provides legitimate SQL migration examples including PostgreSQL functions (gen_random_uuid, pg_sleep), database introspection queries (pg_indexes), and configuration references. No actual command injection, weak cryptography, or data exfiltration present. This is a benign database migration guidance skill.

2
Просканировано файлов
549
Проанализировано строк
4
находки
1
Всего аудитов
Проблемы среднего риска (2)
resources/implementation-playbook.md:31-60resources/implementation-playbook.md:60-64resources/implementation-playbook.md:64-123resources/implementation-playbook.md:325-329resources/implementation-playbook.md:360-366
External Commands Pattern (False Positive)
Scanner flagged SQL/PL/pgSQL syntax as shell commands. Code contains PostgreSQL functions like gen_random_uuid() and pg_sleep() which are legitimate database operations, not shell execution.
resources/implementation-playbook.md:277-283resources/implementation-playbook.md:369-413resources/implementation-playbook.md:429
Database File References (False Positive)
Scanner flagged database file path references as sensitive data. These are legitimate configuration references for migration scripts.
Проблемы низкого риска (2)
resources/implementation-playbook.md:45-46resources/implementation-playbook.md:104-119resources/implementation-playbook.md:411-440
Database Introspection Queries (False Positive)
Scanner flagged pg_indexes queries as system reconnaissance. These are standard database introspection for migration planning.
resources/implementation-playbook.md:340SKILL.md:3SKILL.md:18
Cryptographic Function Flagged (False Positive)
Scanner flagged gen_random_uuid() as weak cryptographic algorithm. This is PostgreSQL's cryptographically secure UUID v4 generator.
Проверено: claude

Оценка качества

38
Архитектура
100
Сопровождаемость
87
Контент
32
Сообщество
91
Безопасность
91
Соответствие спецификации

Что вы можете построить

Добавить новый столбец без простоя

Безопасное добавление столбца NOT NULL в большую продакшн-таблицу с использованием паттерна expand-contract с пакетным заполнением данных.

Миграция устаревшей схемы в новую структуру

Использование blue-green миграции с синхронизацией двойной записи для перехода от устаревшей схемы к новой без потери данных.

Создание безопасных процедур отката

Генерация автоматизированных скриптов отката с пред-миграционными снимками и проверками валидации для восстановления после неудачных миграций.

Попробуйте эти промпты

Базовый запрос миграции 
Создайте скрипт миграции для добавления нового столбца email_verified (BOOLEAN, DEFAULT FALSE) в таблицу users в PostgreSQL. Включите proper error handling.
Мигра��ия с нулевым простоем 
Сгенерируйте стратегию миграции с нулевым простоем для преобразования столбца VARCHAR в тип ENUM в продакшн базе данных MySQL с 10M+ строк.
Миграция данных с валидацией 
Напишите миграцию для перемещения данных из устаревшей таблицы orders в новую таблицу v2_orders. Включите предварительные проверки валидации, пакетное заполнение и проверку количества строк после миграции.
Полная миграция с откатом 
Создайте полный пакет миграции для добавления столбца метаданных JSONB в таблицу products. Включите: SQL прямой миграции, SQL отката, проверки валидации и shell-скрипт для выполнения с proper error handling.

Лучшие практики

  • Всегда создавайте снимок или резервную копию базы данных перед выполнением миграций в продакшене
  • Используйте транзакционные блоки (BEGIN/COMMIT) для обеспечения атомарности шагов миграции
  • Проверяйте количество строк до и после миграции для обнаружения потери данных
  • Тестируйте миграции в staging среде, которая зеркалирует продакшн

Избегать

  • Выполнение миграций непосредственно в продакшене без предварительной валидации
  • Использование ALTER TABLE без флага CONCURRENTLY для больших таблиц в PostgreSQL
  • Пропуск процедур отката для изменений схемы в продакшене
  • Игнорирование ограничений внешних ключей и ссылочной целостности во время миграций

Часто задаваемые вопросы

Какие базы данных поддерживает этот навык?
Этот навык поддерживает PostgreSQL, MySQL и SQL Server. Для NoSQL баз данных, таких как MongoDB, используйте навык nosql-migrations.
Выполняет ли этот навык миграции?
Нет, этот навык генерирует скрипты миграций и рекомендации. Вы должны проверить и выполнить сгенерированный SQL самостоятельно в вашей среде базы данных.
Как обеспечить нулевой простой во время миграций?
Используйте паттерны expand-contract: сначала добавьте новые столбцы/таблицы (обратная совместимость), мигрируйте данные пакетами, затем удалите старые структуры после развертывания кода.
Можно ли использовать с Flyway или Alembic?
Да, навык включает примеры для фреймворков миграций Flyway и Alembic. Сгенерированные скрипты могут быть адаптированы под ваши существующие инструменты миграции.
Какие проверки валидации следует запускать?
Запускайте проверки перед миграцией (NULL значения, дубликаты, целостность внешних ключей) и после миграции (количество строк, валидация ограничений, наличие индексов).
Как обрабатывать неудачные миграции?
Используйте savepoints внутри транзакций, создавайте резервные копии перед миграцией и держите готовые скрипты отката. Навык предоставляет подробные примеры процедур отката.

Сведения для разработчиков

Автор

sickn33

Лицензия

MIT

Репозиторий

https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/database-migrations-sql-migrations

Ссылка

main

Структура файлов

📁 resources/

📄 implementation-playbook.md

📄 SKILL.md