env-fix

環境依存問題を解消して。

context

test_command: {{test_command}} (テスト実行コマンド。未指定の場合は npm test)
test_file: {{test_file}} (対象テストファイル。未指定の場合は全テスト)
error_output: {{error_output}} (エラー出力内容)
error_classification: {{error_classification}} (エラー分類。⚙️設定・環境問題 / 📦依存関係問題)
max_retry: 2 (最大リトライ回数)

step

step0: プロジェクトコンテキストの確認

以下のファイルが存在する場合は読み取り、テスト実行方法や環境要件を把握する:

• CLAUDE.md — テスト実行方法、環境設定の指示
• README.md — セットアップ手順、必要な環境変数、外部サービス要件
• AGENTS.md — エージェント向けの開発ルール、環境関連の注意事項

test_command が未指定の場合は、これらの情報から適切なテストコマンドを決定する。

step1: 環境問題の分析

1. エラー出力の確認

   • error_output が提供されている場合はそれを分析
   • 提供されていない場合はテストを実行してエラーを取得

2. 原因分析（Task tool, subagent_type: Explore, thoroughness: medium）

   • 以下の環境問題パターンに沿って分析:
     • 依存パッケージ不足/不整合: package.json と node_modules の不一致、lockfile の不整合
     • 環境変数未設定: 必要な環境変数が未定義、.env ファイルの不備
     • 設定ファイル不備: 設定ファイルの不足、パス設定の誤り
     • 外部サービス未起動: DB、Redis、メッセージキュー等の未起動
     • Node.js/ランタイムバージョン不整合: .nvmrc / .node-version との不一致
   • 修正可能な問題と手動対応が必要な問題を分類

step2: 自動修正の試行

問題種別に応じた修正を実施:

1. 依存パッケージ不足/不整合の場合

   # lockfileとの同期
   npm ci
   

   • npm ci が失敗した場合:

   rm -rf node_modules && npm install
   

   • Python の場合:

   pip install -r requirements.txt
   

2. 環境変数未設定の場合

   • .env.example / .env.sample / .env.template が存在するか確認
   • 存在する場合: .env.test または .env にコピー
   • 存在しない場合: エラーメッセージから必要な環境変数を特定し、テスト用デフォルト値で .env.test を生成
   • 注意: 機密情報（APIキー等）はプレースホルダで記載し、レポートで手動設定を推奨

3. 設定ファイル不備の場合

   • テンプレートや既存設定からの生成
   • パス設定の修正（相対パス/絶対パスの変換）
   • 不足プロパティの追加

4. 外部サービス未起動の場合

   • docker-compose.yml / compose.yml が存在するか確認
   • 存在する場合:

   docker compose up -d
   

   • 存在しない場合: 手動起動が必要としてレポート

5. ランタイムバージョン不整合の場合

   • .nvmrc / .node-version の内容を報告
   • 自動修正は行わず、レポートで推奨バージョンを記載

step3: テスト再実行による確認

1. テストを再実行

   {{test_command}} 2>&1
   

   • test_file が指定されている場合:

   {{test_command}} -- {{test_file}} 2>&1