164-java-profiling-verify

Java プロファイリングワークフロー / ステップ 4 / 結果の検証

最適化の前後を厳密に比較して、パフォーマンスの最適化を検証します。ベースラインとリファクタリング後のプロファイリングデータが同一のテスト条件を使用していることを確認し、リファクタリング後のレポートを生成します。メトリクス（メモリ、CPU、GC、スレッド）を比較し、フレームグラフを並べて分析します。調査結果を profiling-comparison-analysis-YYYYMMDD.md と profiling-final-results-YYYYMMDD.md に記録し、成功基準を検証します。

このスキルで扱う内容

• リファクタリング前のベースライン：変更前に同じ負荷でプロファイラーを実行します
• リファクタリング後：同一のテスト条件で新しいレポートを生成します
• 比較：メモリ（リーク、割り当て、GC）、CPU（ホットスポット、競合）、フレームグラフの視覚的な比較
• ドキュメント：profiler/docs/profiling-comparison-analysis-YYYYMMDD.md、profiler/docs/profiling-final-results-YYYYMMDD.md
• ファイルの命名：baseline/after のサフィックス、タイムスタンプに基づく整理
• 検証：レポートの存在確認、メトリクスの比較、リグレッションの特定

範囲： テスト条件を同一にすることが重要です。テストシナリオを記録してください。新しいレポートを生成する前に、リファクタリング後のコードでアプリケーションが実行されることを検証してください。

制約

ベースラインとリファクタリング後で同一のテスト条件を使用してください。両方のレポート一式が揃っていることを確認してください。テストシナリオを記録してください。

• 一貫性：ベースラインとリファクタリング後で、同一のテスト条件と負荷パターンを使用します
• 検証：比較の前に、ベースラインとリファクタリング後の両方のレポートが存在し、空でないことを確認します
• 記録：再現できるよう、テストシナリオと負荷パターンを記録します
• 適用する前に：比較テンプレートと検証手順について、リファレンスを読みます
• エッジケース：依頼の範囲が曖昧な場合は、変更を適用する前に中断して確認の質問をします
• エッジケース：必要な入力、ファイル、ツールが不足している場合は、不足しているものを報告し、セットアップの案内を進めてよいか確認します

このスキルを使うタイミング

• パフォーマンス修正を検証する
• パフォーマンスを検証する
• メモリを検証する
• スレッドを検証する
• GC を検証する
• プロファイリングを検証する
• プロファイリング結果の変更前と変更後を比較する
• パフォーマンスベンチマーク
• リファクタリング後にパフォーマンスのリグレッションを確認する

ワークフロー

1. 検証リファレンスを読み、ベースラインデータを確認する

references/164-java-profiling-verify.md を読み、ベースラインの成果物が存在し、空でないことを確認します。

2. リファクタリング後のプロファイリングデータを生成する

同一の負荷／テスト条件でプロファイリングを実行し、比較可能なリファクタリング後の成果物を生成します。

3. 変更前後のメトリクスと視覚情報を比較する

メモリ／CPU／GC／スレッドを定量的に比較し、フレームグラフを並べて分析します。

4. 最終的な検証結果を記録する

リグレッション、改善点、再現可能なシナリオの詳細を含む比較レポートと最終結果レポートを作成します。

リファレンス

詳細なガイダンス、例、制約については、references/164-java-profiling-verify.md を参照してください。