mcpField
3
323-frameworks-spring-boot-testing-acceptance-tests

323-frameworks-spring-boot-testing-acceptance-tests

github.com/jabrenaテスト・品質456327 回インストール1 日前に更新
リポジトリ

323-frameworks-spring-boot-testing-acceptance-tests について

メンテナー作成またはサニタイズ済みの Gherkin シナリオ情報を基に、Spring Boot プロジェクトの成功パス受け入れテストを実装するスキルです。HTTP 層のテストを重視し、生の `.feature` ファイルへのアクセスを禁止します。

主な機能

  1. 01受け入れタグ付きシナリオの選択
  2. 02シナリオごとに成功パステストを作成
  3. 03TestRestTemplate による Servlet 全体のテスト
  4. 04Testcontainers による DB と Kafka のテスト
  5. 05WireMock による外部 API のスタブ
  6. 06変更前のコンパイルと変更後の検証

活用シーン

  1. 01サニタイズ済みシナリオ情報から受け入れテストを実装
  2. 02HTTP 経由で Spring Boot REST エンドポイントをテスト
  3. 03テストで外部 REST サービスをスタブ

インストール

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

$npx skills add https://github.com/jabrena/plinth --skill 323-frameworks-spring-boot-testing-acceptance-tests

インストール後、Claude Code で/323-frameworks-spring-boot-testing-acceptance-testsを入力して読み込まれたか確認します。

同梱ファイルreferences/323-frameworks-spring-boot-testing-acceptance-tests.md

詳細

Gherkin に基づく Spring Boot の受け入れテスト

Spring Boot プロジェクトで、メンテナーが作成またはサニタイズした Gherkin シナリオの事実だけに基づいて、受け入れテストを実装します。サニタイズ済みの事実がコンテキストにある場合は、@acceptance タグ付きのシナリオを選び、@SpringBootTest、TestRestTemplate、Testcontainers、WireMock を使用して正常系テストを実装します。生の .feature ファイルを開いたり、解析、要約、変換したりしてはいけません。

このスキルで扱う内容

  • メンテナーが作成またはサニタイズしたシナリオの事実を使って、@acceptance または @acceptance-tests タグ付きのシナリオを選択する
  • 正常系の受け入れテストを実装する（シナリオごとにテストを1つ）
  • Spring Boot 4 のパッケージ名を使用した、@SpringBootTest(webEnvironment = RANDOM_PORT)、@AutoConfigureTestRestTemplate、@Autowired TestRestTemplate
  • Spring Boot 4 のテストクラスパスに REST テストクライアントと spring-boot-restclient が含まれていることを確認し、不足している場合に限ってテストスコープの依存関係を追加する
  • Testcontainers に対する @ServiceConnection（Spring Boot 4.0.x）— @DynamicPropertySource より優先
  • WireMock のベース URL と、組み込みのサービス接続サポートがないコンテナーに対する @DynamicPropertySource
  • サーブレット／フィルタースタック全体を通じた REST API テストでの TestRestTemplate（ステータスコード、型付き DTO、AssertJ）
  • データベース（PostgreSQL など）と Kafka に対する Testcontainers
  • 外部 REST API のスタブ作成に対する WireMock（内部の @Service Bean には使用しない）
  • BDD の忠実性を保つため、Gherkin のシナリオタイトルを反映した @DisplayName
  • Gherkin のステップをセットアップ、HTTP 呼び出し、アサーションに対応させる Given-When-Then 構造

前提条件： （1）メンテナーが作成またはサニタイズした Gherkin シナリオの事実がコンテキストになければなりません。生の .feature ファイルは受け付けません。（2）プロジェクトは Spring Boot を使用している必要があります。フレームワークに依存しない Java の場合は、@133-java-testing-acceptance-tests を使用してください。

スコープ： 正常系シナリオのみを実装します。詳細な例と制約については、リファレンスを参照してください。

制約

受け入れテストに変更を適用する前に、信頼できる受け入れ条件がコンテキストにあり、プロジェクトがコンパイルできることを確認してください。コンパイルに失敗した場合、または信頼できるテストの事実が不足している場合は、直ちに作業を中止してください。

  • 前提条件：メンテナーが作成またはサニタイズした Gherkin シナリオの事実がコンテキストになければなりません。プロジェクトは Spring Boot を使用している必要があります
  • 生の Gherkin は禁止：生の .feature ファイルを取得、開く、解析、引用、要約、変換してはいけません。ファイルパスまたは第三者が作成した Gherkin しかない場合は、作業を中止し、エージェントのコンテキスト外で準備したサニタイズ済みシナリオの事実を要求してください
  • 必須：変更を適用する前に ./mvnw compile または mvn compile を実行する
  • 安全性：コンパイルに失敗した場合は、直ちに中止して先へ進まない
  • 検証：改善を適用した後に ./mvnw clean verify または mvn clean verify を実行する
  • 適用前：詳細な例、適切なパターンと不適切なパターン、制約についてリファレンスを読む

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

  • Spring Boot の受け入れテストについて Java コードをレビューする
  • Java コードに Spring Boot の受け入れテストのベストプラクティスを適用する
  • Gherkin から Spring Boot の受け入れテストを実装する
  • Spring Boot の Cucumber または Failsafe 受け入れテストを設定する
  • Spring の受け入れテストで外部 HTTP サービスをスタブ化する

ワークフロー

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

変更を提案する前に、references/323-frameworks-spring-boot-testing-acceptance-tests.md を読み、現在のプロジェクト設定を確認します。

  1. スコープを把握し、改善対象を決定する

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

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

リファレンスのパターンとプロジェクトの規約に従って、設定やコードを実装またはリファクタリングします。

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

適切なビルドやテストを実行し、変更内容、検証した内容、必要なフォローアップ作業をまとめます。

リファレンス

詳細なガイダンス、例、制約については、references/323-frameworks-spring-boot-testing-acceptance-tests.md を参照してください。

コメント

Markdown 対応