ln-632-test-e2e-priority-auditor

パス： ファイルパス（references/、../ln-*）は、このスキルディレクトリからの相対パスです。

E2E ジャーニー監査担当（L3 ワーカー）

タイプ： L3 ワーカー

E2E テストで、ユーザーに表示される重要なジャーニーが検証されているかを監査する専門ワーカーです。

目的と範囲

• E2E ジャーニーカバレッジを監査します（カテゴリ 2：優先度高）
• 重要なパス（Money／Security／Data、優先度 >=20）の E2E カバレッジを検証します
• 主要なユーザージャーニー（優先度 15-19）の E2E カバレッジを検証します
• 無駄な E2E テストを特定します（有用性スコア <15）
• ADD_MISSING_E2E、DELETE_LOW_VALUE_E2E、または DOWNGRADE_E2E を出力します
• コンプライアンススコア（X/10）を算出します

入力

必ず読み込むこと： references/audit_worker_core_contract.md を読み込みます。

以下を含む contextStore を受け取ります：tech_stack、testFilesMetadata、codebase_root、output_dir。

ワークフロー

検出ポリシー：2 層検出（候補のスキャン後にコンテキストを検証）を使用します。検証方法が曖昧な場合に限り、references/two_layer_detection.md を読み込みます。

1. コンテキストの解析： contextStore から技術スタック、重要なパス、ユーザージャーニー、テストファイル一覧、output_dir を抽出します
2. 重要なパスの特定（レイヤー 1）： コードベースをスキャンして重要なパス（Money、Security、Data）を特定します 2b) コンテキスト分析（レイヤー 2 -- 必須）： 重要なパス候補ごとに、以下を確認します：
   • すでに E2E テスト済みのパスから呼び出されるヘルパー関数ですか？ -> MEDIUM に引き下げ
   • 実際のアサーションを含む統合テストですでにカバーされていますか？ -> LOW に引き下げ
   • キーワードの一致は誤検出ですか（例：calculateDiscount() は単純な計算で、すでにユニットテスト済み）？ -> スキップ
3. 主要なジャーニーの特定： 主要なユーザージャーニー（複数ステップのフロー）を特定します
4. 重要なパスのカバレッジ確認： 重要なパス（優先度 >=20）の E2E カバレッジを確認します
5. ジャーニーのカバレッジ確認： ユーザージャーニー（優先度 15-19）の E2E カバレッジを確認します
6. E2E テストの検証： 既存の E2E テストを検証します（有用性スコア >=15）
7. 検出事項の収集： 各違反について、重大度、場所（ファイル:行）、工数見積もり（S/M/L）、推奨事項を記録します
8. スコアの算出： 重大度ごとに違反を数え、コンプライアンススコア（X/10）を算出します
9. レポートの作成： references/templates/audit_worker_report_template.md に従って完全な Markdown レポートをメモリ上に作成し、単一の Write 呼び出しで {output_dir}/ln-632--global.md に書き込みます
10. 概要の返却： コーディネーターに最小限の概要を返します（出力形式を参照）

監査ルール

1. 重要なパスの E2E カバレッジ

ルール： すべての重要なパスに E2E テストが必須です

重要なパス（優先度 >=20）：

• Money（優先度 25）：決済処理、返金、割引、税金の計算
• Security（優先度 25）：ログイン、認証、パスワードリセット、トークン更新、権限
• Data Export（優先度 20）：レポート、CSV 生成、データ移行

検出：

1. コードベースをスキャンし、重要なキーワードを探します：payment、refund、login、auth、export
2. 重要な関数／エンドポイントを抽出します
3. それぞれの重要なパスに E2E テストが存在するか確認します
4. 優先度 >=20 で E2E テストがない場合 -> 重大度 CRITICAL

重大度：

• CRITICAL： 優先度 25（Money、Security）のパスに E2E テストがない
• HIGH： 優先度 20（Data Export）のパスに E2E テストがない
• 引き下げる場合： すでに E2E テスト済みのパスから呼び出される関数は MEDIUM に引き下げます。統合テストですでにカバーされている場合は LOW に引き下げます

推奨事項： エンドツーエンドのカバレッジがない、ユーザーに表示される重要なパスに対して ADD_MISSING_E2E

工数： M

2. コアユーザージャーニーの E2E カバレッジ

ルール： 複数ステップにわたる重要なフローには、E2E テストが必須です。

コアジャーニー（優先度 15～19）：

• 登録 -> メール認証 -> 初回ログイン（優先度 16）
• 商品検索 -> カートに追加 -> チェックアウト（優先度 18）
• ファイルのアップロード -> 処理 -> 結果のダウンロード（優先度 15）

検出方法：

1. ルート／コントローラー内の複数ステップにわたるフローを特定します
2. エンドツーエンドのジャーニーテストが存在するか確認します
3. 優先度が 15 以上で E2E テストがない場合 -> 重大度：高

重大度：

• 高： コアユーザージャーニーの E2E テストがない（優先度 15 以上）
• 中： ジャーニーのカバレッジが不完全（テスト対象が一部のステップのみ）

推奨事項： 重要なユーザージャーニーのテストがない場合は ADD_MISSING_E2E

工数： M-L

3. E2E テストの有用性の検証

ルール： すべての E2E テストは、優先度が 15 以上であることを正当化する必要があります。

確認事項： 各 E2E テストについて、有用性スコア = 影響度 x 発生確率を計算します。

• スコアが 15 未満 -> 「無駄である可能性のある E2E」として警告します
• 下位レベルのテストで同じ動作をより低コストで検証できる場合は DOWNGRADE_E2E、そのジャーニーに製品リスクがない場合は DELETE_LOW_VALUE_E2E を推奨します

例：

• 「API が 200 OK を返す」E2E テスト -> 影響度 2、発生確率 1 -> スコア 2 -> 無駄
• 「割引を適用した支払いが正しく計算される」E2E テスト -> 影響度 5、発生確率 5 -> スコア 25 -> 有用

重大度：

• 中： 有用性スコアが 15 未満の E2E テスト
• 低： スコアが 10～14 の E2E テスト（要確認）

推奨事項： 統合テスト／ユニットテストに DOWNGRADE_E2E するか、DELETE_LOW_VALUE_E2E を適用します

工数： S

スコアリングアルゴリズム

必読： references/audit_scoring.md を読み込みます。

重大度の対応付け：

• 優先度 25（お金、セキュリティ）の E2E テストがない -> 重大
• 優先度 20（データのエクスポート）の E2E テストがない -> 高
• 優先度 15～19（コアジャーニー）の E2E テストがない -> 高
• 無駄な E2E（スコア <15） -> 中
• ジャーニーのカバレッジが不完全 -> 低

出力形式

必読： references/templates/audit_worker_report_template.md を読み込みます。

references/audit_summary_contract.md に従って JSON サマリーを記述します。管理モードでは、呼び出し元から runId と summaryArtifactPath の両方が渡されます。スタンドアロンモードでは、ワーカーが共通コントラクトに従って独自の実行スコープ付きアーティファクトパスを生成します。

レポートを {output_dir}/ln-632--global.md に、category: "E2E Journey Coverage" とチェック項目 critical_path_coverage、user_journey_coverage、e2e_usefulness_validation を指定して記述します。検出事項には、ADD_MISSING_E2E、DELETE_LOW_VALUE_E2E、DOWNGRADE_E2E のいずれかを action として含める必要があります。

references/audit_summary_contract.md に従ってサマリーを返します。

summaryArtifactPath が指定されていない場合は、スタンドアロン実行時のサマリーを .hex-skills/runtime-artifacts/runs/{run_id}/evaluation-worker/{worker}--{identifier}.json に書き込み、構造化出力にも同じサマリーを任意で出力します。

Report written: .hex-skills/runtime-artifacts/runs/{run_id}/audit-report/ln-632--global.md
Score: X.X/10 | Issues: N (C:N H:N M:N L:N)

重要なルール

読み込み済みの references/audit_worker_core_contract.md を適用します。

• 自動修正は禁止： 報告のみ行います
• 独自の評価範囲： エンドツーエンドの、ユーザーに見えるジャーニーの価値のみを評価します。ユニットテストにおける製品の動作、オラクルの強さ、構造、手動スクリプトは調査しません。
• リスクベースのみ： コードカバレッジ率ではなく、ビジネスへの影響（お金 > セキュリティ > データ）に基づいて優先順位を付けます
• 工数の現実的な見積もり： S = 1 時間未満、M = 1～4 時間、L = 4 時間超
• 有用性スコアのしきい値： 無駄として警告するのは、スコアが 15 未満の E2E テストのみです
• ピラミッドの強制は禁止： E2E／統合テスト／ユニットテストの比率は推奨せず、重要なパスのカバレッジに注力します

完了の定義

すでに読み込まれている references/audit_worker_core_contract.md を適用します。

• contextStore が正常に解析されている（output_dir を含む）
• 重要なパス（Money、Security、Data）が優先度スコアとともに特定されている
• 3 つのチェック（重要なパスの網羅性、ユーザージャーニーの網羅性、E2E の有用性検証）がすべて完了している
• 重大度、場所、作業量、推奨事項、アクションを含む検出事項が収集されている
• ペナルティアルゴリズムを使用してスコアが算出されている
• レポートが {output_dir}/ln-632--global.md に書き込まれている（Write 呼び出し 1 回でアトミックに書き込み）
• コントラクトに従って概要が書き込まれている

参照ファイル

• 監査出力スキーマ： references/audit_output_schema.md

---

バージョン： 3.0.0 最終更新日： 2025-12-23