check-migration

Flywayマイグレーションチェックスキル - マイグレーションファイルの検証、バージョン番号の競合チェック、命名規則チェック、SQL構文チェックを実施します。mainブランチとの競合確認も行い、マイグレーションの品質を保証します。

⭐0stars🔀0forks📁View on GitHub🕐Updated Jan 5, 2026⬇️1downloads

When & Why to Use This Skill

This Claude skill automates the validation of Flyway migration files to ensure database schema integrity and deployment reliability. It performs comprehensive checks on version numbering, naming conventions, and SQL syntax while identifying potential conflicts with the main branch, effectively preventing 'out-of-order' migration errors and maintaining high-quality database evolution standards.

Use Cases

  • Pre-merge Validation: Automatically verify new migration scripts in Pull Requests to ensure they follow the required naming conventions and maintain a strict version sequence.
  • Conflict Detection: Identify version number overlaps with the main branch during local development to prevent deployment failures caused by duplicate migration IDs.
  • SQL Quality Assurance: Validate SQL scripts for idempotency (e.g., ensuring 'IF NOT EXISTS' usage) and basic syntax correctness to guarantee that migrations can be safely executed across different environments.
  • Migration History Audit: Quickly scan the existing migration directory to find gaps in version numbers or non-compliant file names that could disrupt the Flyway baseline.
namecheck-migration
descriptionFlywayマイグレーションチェックスキル - マイグレーションファイルの検証、バージョン番号の競合チェック、命名規則チェック、SQL構文チェックを実施します。mainブランチとの競合確認も行い、マイグレーションの品質を保証します。

Check Migration Skill - Flywayマイグレーションチェックスキル

役割

Flywayマイグレーションファイルの検証を行うスキルです。バージョン番号の競合チェック、命名規則チェック、SQL構文チェックを実施します。

実行フロー

Phase 1: マイグレーションファイル一覧取得

# マイグレーションファイル一覧
ls -l backend/src/main/resources/db/migration/

# バージョン番号抽出
ls backend/src/main/resources/db/migration/ | grep -E "^V[0-9]+__.*\.sql$"

Phase 2: バージョン番号チェック

  1. バージョン番号の連続性確認
  2. 重複チェック
  3. 欠番チェック

Phase 3: 命名規則チェック

  • 形式: V{連番}__{説明}.sql
  • 例: V001__create_users_table.sql

Phase 4: mainブランチとの競合チェック

# mainブランチの最新マイグレーションファイル取得
git fetch origin
git diff origin/main...HEAD --name-only | grep "db/migration"

# 競合するバージョン番号がないか確認

Phase 5: SQL構文チェック(簡易)

  • CREATE TABLE の存在確認
  • IF NOT EXISTS の使用確認(冪等性)

Phase 6: 完了報告

## Check Migration 完了報告

### マイグレーションファイル
- 総数: [数] ファイル
- 最新バージョン: V[番号]

### チェック結果
- ✅ バージョン番号: 連続性OK、重複なし
- ✅ 命名規則: 準拠
- ✅ mainブランチとの競合: なし
- ✅ 冪等性: IF NOT EXISTS使用

### 次のステップ
マイグレーションファイルは問題ありません。