Communitygithub.com

Javaテスター

レガシーJavaモダナイゼーション(Struts 2 から Spring への移行、Hibernate から JPA Criteria への移行、テスト設計、本番ログ出力)のためのエージェントスキル。

Javaテスター とは?

このスキルは、レガシーJavaシステムのモダナイゼーションプロジェクトにおいて、テスティング戦略の設計と実装を支援します。特に、Struts 2 から Spring への移行、Hibernate から JPA Criteria への移行といった大規模なリファクタリングを伴うシナリオで、テストの信頼性と保守性を高めることを目的としています。テストピラミッドの原則に従い、高速な単体テストを優先し、統合テストやE2Eテストは必要最小限に抑えます。このスキルは、Claude Code、Cursor、Codexなどの主要なAIエージェントプラットフォームで動作し、プロジェクトの既存テストスタイルを尊重しつつ、JUnit、Mockito、AssertJ、Spring Boot Test、Testcontainersなど主要なJavaテスティングツールの最新のベストプラクティスに基づいたテストコードを生成します。Context7を活用してドキュメントを参照し、バージョン依存の詳細を正確に扱います。また、実装、レビュー、デバッグ、組織化/CI計画という4つのタスクモードを提供し、状況に応じた最適なアクションを実行します。ワークフローは、保護すべき振る舞いの特定、テストレベルの選択、フォーカスしたカバレッジの実装、テストの保守性、検証と報告の5段階で構成され、一貫性と実用性を重視します。

対応~Claude Code✓Codex CLI~Cursor
npx skills add ViachaslauStrelnikau/agent-skills

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Javaテスター は何をしますか?

運用モデル

テストピラミッドの最も低い実用的なレベルで、信頼性を高めるテストを追加します。多数の高速な単体テスト、少数の統合テストまたはコントラクトテスト、そして重要なジャーニーのためのごく少数のエンドツーエンドテストを優先します。

まず、プロダクションコード、既存のテスト、ビルドファイル、CIの規則を読んでください。プロジェクトのテストスタイルが明らかに弱いか一貫性がない場合を除き、それを保持してください。プロジェクトに適切な同等のライブラリがすでに存在する場合、新しいテストライブラリを導入しないでください。

JUnit、Mockito、AssertJ、Spring Boot Test、Testcontainers、REST Assured、Pact、WireMock、Maven、Gradle、またはその他のJavaテスティングツールのライブラリ固有の構文、設定、アノテーション、拡張機能、依存関係バージョンを追加または変更する前に、Context7を使用して最新のドキュメントを参照してください。Context7が利用できない、またはライブラリを解決できない場合は、公式のプロジェクトドキュメントを使用してください。バージョンに依存する詳細を推測しないでください。

タスクモードの選択

  • 実装の場合: 変更された振る舞いを特定し、最小限の有用なテストセットを追加して検証します。
  • レビューの場合: 既存のテストスイートを検査し、正しさ、不足しているリスクカバレッジ、脆弱性、重複、分離の問題、ランタイムコストを報告します。ユーザーが変更を要求しない限り、編集しないでください。
  • デバッグの場合: 障害を狭い範囲で再現し、その原因を分類し、ユーザーが要求した範囲内でのみテストまたはプロダクションコードを変更します。
  • 組織化またはCI計画の場合: テストタイプ、ソースセット、ランタイム、依存関係、現在のパイプラインステージを棚卸ししてから、配置、選択、並列化、キャッシュを推奨します。

ワークフロー

  1. 保護すべき振る舞いを特定する。

    • リクエストに関連するパブリックAPI、サービスのメソッド、ドメインルール、永続化の境界、メッセージングハンドラ、コントローラ、スケジューラ、エラーパスを見つけます。
    • 実装のアサーションよりも振る舞いのアサーションを優先します。
    • プライベートメソッドは実装の詳細として扱います。パブリックな振る舞いを通じてテストするか、プライベートロジックが複雑な場合は焦点を絞ったコラボレーターを抽出します。
  2. 最も低い有用なテストレベルを選択する。

    • 純粋なドメインロジック、分岐、バリデーション、マッピング、および実際のI/Oなしでテストできるコラボレーターオーケストレーションには単体テストを使用します。
    • フレームワークの配線、永続化クエリ、データマイグレーション、シリアライゼーション、トランザクション、HTTPルーティング、セキュリティフィルタ、外部境界アダプターにはスライステストまたは統合テストを使用します。
    • サービス境界が複数のチームまたは独立したデプロイユニットによって所有されている場合は、コントラクトテストを使用します。
    • 低レベルのテストでは信頼できないコアフローのみにエンドツーエンドテストを使用します。
  3. フォーカスしたカバレッジを実装する。

    • ハッピーパス、エッジケース、境界値、無効な入力、障害、セキュリティ認可の結果、データベース状態の変更、回帰ケースをカバーします。
    • 繰り返される入出力の例にはパラメータ化テストを使用します。
    • テストごとに1つの失敗理由を維持します。テストには振る舞いと期待される結果に基づいて名前を付けます。
    • 決定論的なデータを使用します。スリープ、壁時計の仮定、ランダムな順序、ネットワーク依存、共有ミュータブル状態を避けます。
  4. テストの保守性を保つ。

    • arrange/act/assert または given/when/then を一貫して使用します。
    • 繰り返されるセットアップが意図を不明瞭にする場合にのみ、ビルダー、フィクスチャ、またはテストデータマザーを作成します。
    • モックはプロセス境界または本当に扱いにくいコラボレーターに限定します。値オブジェクト、コレクション、または些細なドメインロジックをモックしないでください。
    • すべてのインタラクションを検証しないでください。最初に結果を検証し、インタラクションが振る舞いそのものである場合にのみインタラクションを検証します。
  5. 検証して報告する。

    • リポジトリのラッパー、モジュール、プラグイン、ソースセット、CI設定からコマンドを発見します。ビルドおよび障害処理のルールについては references/java-testing-tooling.md を参照してください。
    • 最初に最も狭い関連テストコマンドを実行し、影響範囲がそれを正当化する場合は、より広いスイートを実行します。
    • 高レベルのテストが、どの低レベルのテストも捕捉していないバグを露呈した場合は、低レベルの回帰テストを追加します。
    • 低レベルのテストがすでに条件をカバーしており、高レベルのテストが独自の信頼性を追加しない場合は、重複する高レベルのチェックを削除するか避けます。
    • 追加またはレビューしたテスト、カバーされた振る舞い、コマンドと結果、失敗または利用不可のチェック、および残りのリスクを報告します。新しい失敗と、確認済みの既存または環境障害を区別します。

参考文献

テスト範囲、CI配置、重複、または追加するエンドツーエンドテストの量を決定するときは、references/test-pyramid.md を参照してください。

Javaテスティングツール、依存関係、アノテーション、モッキングスタイル、Spring Bootテストの形状、Testcontainersパターン、APIテスト、コントラクトテスト、ビルドコマンド、障害分類を選択するときは、references/java-testing-tooling.md を参照してください。

関連スキル