Openclaw向けMigration Validator

実行前に保留中の SQL マイグレーションを自動的にスキャンして検証し、パイプラインの失敗を防ぐデータベースツールです。

ink5725
v1.0.0
Jun 2, 2026
0
562
0

インストール&ダウンロード

1. ClawHub CLI

レジストリから直接スキルをインストールする最速の方法です。

npx clawhub@latest install migration-validator

2. 手動インストール

スキルフォルダを以下のいずれかの場所にコピーしてください

グローバル
~/.openclaw/skills/
ワークスペース
<project>/skills/

優先順位:ワークスペース > ローカル > バンドル

3. プロンプトのインストール

このプロンプトをOpenClawにコピーするだけで、自動的にインストールされます。

Clawhubを使って migration-validator をインストールして。Clawhubがインストールされていない場合は、先にインストールしてください(npm i -g clawhub)。

ダウンロードをご希望ですか?

ZIPアーカイブで生のスキルファイルを取得します。

Migration Validator とは?

Migration Validator は、マイグレーションディレクトリ内の保留中の SQL データベースマイグレーションファイルをスキャンし、デプロイ前に構文の正確性を保証するように設計された必須のユーティリティです。検証アルゴリズムを実行し、マイグレーションスクリプトを解析することで、現代のソフトウェアリリースサイクルにおいて不可欠な安全装置として機能します。

Openclaw Skills を通じてこのツールを統合することで自動化されたスキーマ保護が可能になり、開発者は構文のタイプミスや構造的な不整合によるデータベースのランタイムエラーを排除できます。マイグレーションの実行状態を管理・記録し、どのマイグレーションが保留中か、または完了済みかを識別します。

Migration Validator のユースケース

  • デプロイのゲートキーピング: 実行前に SQL マイグレーションスクリプト内の構文問題や構造エラーを検出します。
  • CI/CD 統合: pull request やデプロイパイプラインで SQL ファイルを自動検証するブロック用の事前ステップとして機能します。
  • マルチ環境の整合性: マイグレーションスクリプトが開発、ステージング、本番環境全体で相互互換性があり、有効であることを確認します。

Migration Validator の仕組み

  1. ディレクトリ検出: このスキルは指定されたマイグレーションディレクトリ(例:migrations/)をスキャンし、すべての候補 SQL ファイルを識別します。
  2. 構文検証: 各 SQL ファイルは、特殊な構文エンジン(例:SQLite PRAGMA ステートメント検証またはネイティブ SQL パーサー)を使用して解析および検証されます。
  3. 状態追跡: このツールは、保留中のマイグレーションファイルを以前に実行されたマイグレーションと照合して、データベースの差異状態を特定します。
  4. レポート出力: 実行ステータス、エラー、識別されたマイグレーションを含む構造化された JSON 検証レポートが生成されます。

Migration Validator のセットアップ

Openclaw Skills スイート内でこのマイグレーションユーティリティを活用するには、プロジェクトのワークスペースを構成し、以下のように検証スクリプトを実行してください:

# マイグレーションを含むプロジェクトディレクトリへ移動
cd /path/to/your/project

# 検証スクリプトの実行
python scripts/validate.py

仮想環境内にデータベースドライバと python の依存関係が設定されていることを確認してください。

Migration Validator のデータスキーマとタクソノミー

このツールは SQL マイグレーション構造を評価し、スキーマ準拠の JSON 検証レポートを生成します。以下は検証メタデータ出力の構造です:

プロパティ 型 説明
validation_timestamp String 検証実行の ISO 8601 タイムスタンプ
migrations_found Array フォルダ内で検出された SQL ファイル名のリスト
pending_migrations Array ターゲットデータベースにまだ適用されていない SQL ファイル
validation_errors Array 構文検証から解析された詳細なエラー
status String 一般的な検証ステータス(例:completed, failed)

出力例:

{
  "validation_timestamp": "2026-06-01T12:00:00",
  "migrations_found": ["001_initial.sql", "002_create_orders.sql"],
  "pending_migrations": [],
  "validation_errors": [],
  "status": "completed"
}

Migration Validator の高度な機能

  • Dry-Run 検証: アクティブなデータベース状態を変更せずにスキーマ解析を実行します。
  • 構成可能な解析エンジン: SQLite、PostgreSQL、または MySQL スキーマに合わせて調整された方言固有の検証チェックを選択します。
  • Openclaw Skills 自動化: migration-validator をマルチエージェントオーケストレーションパイプラインと簡単に接続し、自動ロールバックや pre-commit フックを実現します。

SKILL.md


ローディング

関連するOpenclawのスキル

METADATA

Github Stars: 0
forks: 0

特徴*