mcpField
4
413-frameworks-quarkus-db-migrations-flyway

413-frameworks-quarkus-db-migrations-flyway

github.com/jabrenaデータ・データベース456316 回インストール1 日前に更新
リポジトリ

413-frameworks-quarkus-db-migrations-flyway について

Quarkus プロジェクトで Flyway によるデータベース移行を適用・レビューするスキルです。コンパイルの事前確認、移行の安全性、破壊的なスキーマ変更の段階的な処理を重視します。

主な機能

  1. 01Quarkus Flyway の設定
  2. 02バージョン付き SQL の配置
  3. 03複数データソースへの対応
  4. 04拡張・移行・縮小の手順
  5. 05コンパイルと検証の安全策

活用シーン

  1. 01Quarkus の Flyway 移行の追加やレビュー
  2. 02移行場所やベースラインの設定
  3. 03スキーマ変更の互換性評価

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/jabrena/plinth --skill 413-frameworks-quarkus-db-migrations-flyway

インストール後、Claude Code で/413-frameworks-quarkus-db-migrations-flywayを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
413-frameworks-quarkus-db-migrations-flyway-parallel-change.md
413-frameworks-quarkus-db-migrations-flyway.md
413-frameworks-quarkus-db-migrations-flyway-antipatterns.md

詳細

Quarkus — データベースのマイグレーション（Flyway）

Quarkus に Flyway のマイグレーションガイドラインを適用します。

このスキルの対象範囲

  • quarkus-jdbc-* ドライバーと組み合わせた quarkus-flyway
  • src/main/resources/db/migration 配下のバージョン管理された SQL
  • quarkus.flyway.migrate-at-start、ロケーション、ベースラインオプション
  • 複数のデータソース（該当する場合）
  • 破壊的変更やデータに影響するスキーマ変更に対する、安全な拡張、移行、縮小のワークフローとしての Parallel Change
  • @411-frameworks-quarkus-jdbc および @412-frameworks-quarkus-panache との連携

対象範囲： リファレンスのルールと適切な例・不適切な例に基づいて、推奨事項を適用します。

制約事項

Flyway または SQL の変更を適用する前に、プロジェクトがコンパイルできることを確認してください。改善後は、完全な検証を実行してください。

  • 必須：変更を適用する前に ./mvnw compile または mvn compile を実行します
  • 安全性：コンパイルに失敗した場合は、直ちに中止します
  • 検証：改善を適用した後に ./mvnw clean verify または mvn clean verify を実行します
  • 適用前：詳細なルールと適切・不適切なパターンを確認するため、リファレンスを読みます
  • 破壊的変更のレビュー：マイグレーションを推奨または適用する前に、デプロイ済みのアプリケーションバージョン、依存サービス、レポート、ジョブ、本番データの解釈に影響する可能性があるかを評価します。影響する可能性がある場合は、先に進む前に人間による明示的なレビューを求めます
  • エッジケース：ユーザーの目的が曖昧な場合は、ファイルの編集やプロジェクト全体に対するコマンドの実行を始める前に中止し、確認の質問をします
  • エッジケース：必要なコンテキスト、ファイル、認証情報、ツールが不足している場合は、阻害要因を明示して報告し、セットアップまたは代替手段による案内を進めるかユーザーに確認します
  • エッジケース：要求された変更がプロジェクトの制約や安全上の境界に反する場合は、競合点を説明し、どのトレードオフを優先するかユーザーに確認します

このスキルを使用する場合

  • Quarkus プロジェクトで Flyway のマイグレーションを追加またはレビューする
  • quarkus-flyway または db/migration のレイアウトを設定する
  • Quarkus 用のバージョン管理された Flyway SQL マイグレーションを追加する
  • Quarkus のデータベースマイグレーションの順序をレビューする
  • Quarkus で Flyway のクリーン、マイグレーション、またはベースラインを設定する

ワークフロー

  1. リファレンスを読み、プロジェクトのコンテキストを評価する

変更を提案する前に、references/413-frameworks-quarkus-db-migrations-flyway.md、references/413-frameworks-quarkus-db-migrations-flyway-antipatterns.md、および references/413-frameworks-quarkus-db-migrations-flyway-parallel-change.md を読み、現在のプロジェクト設定を確認します。

  1. 対象範囲を把握し、改善内容を決定する

求められる成果と制約を特定し、適用する変更を安全な最小限の範囲に絞ります。

  1. フレームワークに沿った変更を適用する

リファレンスのパターンとプロジェクトの規約に従って、設定やコードを実装またはリファクタリングします。破壊的変更やデータに影響するスキーマ変更に対する安全な既定の方法として、Parallel Change（拡張、移行、縮小）を使用します。

  1. 検証を実行し、結果を報告する

適切なビルドやテストを実行し、変更内容、検証内容、必要な後続作業をまとめます。

リファレンス

詳細なガイダンス、例、制約については、以下を参照してください。

コメント

Markdown 対応