mcpField
5
513-frameworks-micronaut-db-migrations-flyway

513-frameworks-micronaut-db-migrations-flyway

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

513-frameworks-micronaut-db-migrations-flyway について

Micronaut プロジェクトで Flyway のデータベース移行を設定・レビューするスキルです。移行配置やデータソース、テスト、段階的なスキーマ変更を扱い、破壊的変更の安全確認を求めます。

主な機能

  1. 01Micronaut Flyway と JDBC の設定
  2. 02バージョン管理された SQL 移行配置
  3. 03データソース別 Flyway 設定
  4. 04Testcontainers による移行テスト
  5. 05拡張・移行・縮小の手順
  6. 06破壊的変更の安全レビュー

活用シーン

  1. 01Micronaut の移行追加・レビュー
  2. 02Flyway データソースの設定
  3. 03移行順序の確認
  4. 04データに関わるスキーマ変更の計画

インストール

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

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

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

同梱ファイル

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

references/
513-frameworks-micronaut-db-migrations-flyway-parallel-change.md
513-frameworks-micronaut-db-migrations-flyway.md
513-frameworks-micronaut-db-migrations-flyway-antipatterns.md

詳細

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

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

このスキルの対象範囲

  • JDBC/Hikari およびデータベースドライバーを使用する micronaut-flyway
  • src/main/resources/db/migration 配下のバージョン管理された SQL
  • YAML/properties での flyway.datasources.*（データソースごと）設定
  • Testcontainers と実際のマイグレーションチェーンを使用したテスト
  • 互換性を損なうスキーマ変更やデータに影響するスキーマ変更に対する、安全な拡張、移行、縮小のワークフローとしての Parallel Change
  • @511-frameworks-micronaut-jdbc および @512-frameworks-micronaut-data との連携

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

制約

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

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

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

  • Micronaut プロジェクトで Flyway マイグレーションを追加またはレビューする
  • micronaut-flyway または db/migration の構成を設定する
  • Micronaut 向けにバージョン管理された Flyway SQL マイグレーションを追加する
  • Micronaut のデータベースマイグレーションの順序をレビューする
  • Micronaut プロジェクトで Flyway のデータソースを設定する

ワークフロー

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

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

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

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

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

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

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

適切なビルドとテストを実行し、変更内容、検証した内容、および今後の対応を要約します。

リファレンス

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

コメント

Markdown 対応