---

name: claude-code-e2e-automation description: Claude CodeでE2E自動テストを実行するスキル。qa-engineerエージェントの正しい起動方法、権限問題の対処、pty監視体制の構築を含む。「E2Eテスト実行」「qa-engineer起動」「Claude Code自動化」「ブラウザテスト」「権限エラー対処」などの作業に使う。

Claude Code E2E自動化スキル

概要

Claude Codeのqa-engineerエージェントでE2Eテストを自動実行するための完全ガイド。 ブラウザ操作を伴うテストの特性上、権限問題・停止・入力待ちへの対処が重要。

重要な前提知識

backgroundでは実行不可

# これは失敗する
sessions_spawn(agentId="qa-engineer", task="E2Eテスト実行")

理由:

• ブラウザ操作の確認が必要
• エラー時の即座対応が必要
• 認証・セットアップの動的変更が必要

ptyでリアルタイム実行が必須

# 正しい方法
exec command="claude --agent qa-engineer --dangerously-skip-permissions" pty=true

実行手順

Step 1: Claude Code + qa-engineer起動

推奨コマンド（けいたさん承認済み）:

cd /Users/satokeita/Dev/history-quiz-app && claude --agent qa-engineer --dangerously-skip-permissions

オプション説明:

• --agent qa-engineer: QA専門エージェント指定
• --dangerously-skip-permissions: 全権限チェックスキップ
• pty=true: リアルタイム対話モード

代替オプション（権限制御したい場合）:

claude --agent qa-engineer --permission-mode acceptEdits

Step 2: タスク指示

タスク指示テンプレートと送信方法は以下を参照: references/template-task-instruction.md

Step 3: 監視体制構築

必須: 2分おきの監視cronを設定

監視cronの設定JSONは以下を参照: references/config-monitor-cron.json

進捗報告ルール（重要）

チャンネル本文への頻繁投稿禁止

• cronでの進捗報告を チャンネル本文に直接投稿してはいけない
• チャンネル全体が荒れる原因となる

スレッド投稿を活用

• E2Eテスト開始時: チャンネル本文に「E2Eテスト開始」メッセージを投稿
• 進捗・監視報告: 開始メッセージのスレッドに投稿
• 完了報告: チャンネル本文に最終結果のみ投稿

実装方法

Slack報告の実装パターン（開始・監視・完了）は以下を参照: scripts/slack-reporting.js

問題発生パターンと対処法

各問題パターンの症状と対処コードは以下を参照: references/troubleshooting-handlers.md

対処すべき問題一覧:

1. 長時間停止状態 - Prestigitating/Hullaballooing が5分以上継続 → Enter送信→強制リセット
2. 権限エラー - "may only create directories" → "a" + Enter送信で承認
3. Signal 9 強制終了 - セッションリセット後、権限スキップで再起動
4. エージェント認識エラー - .claude/agents/qa-engineer.md の存在確認、名前の大文字小文字に注意

監視cronの実装

監視ロジック（完了検知・停止検知・権限待ち検知・自動対処）の実装は以下を参照: scripts/monitor-logic.js

トラブルシューティング

よくある失敗原因

1. backgroundで実行: E2Eテストは必ずptyでリアルタイム実行
2. 権限設定不足: --dangerously-skip-permissions が最も確実
3. 監視なし: 長時間実行では必ず監視cronをセット
4. エージェント指定忘れ: --agent qa-engineer は必須

成功の条件

• 正しいコマンド: claude --agent qa-engineer --dangerously-skip-permissions
• ptyモード: pty=true でリアルタイム対話
• 監視体制: 2分おきの自動チェック
• 権限設定: 完全スキップで中断なし

実行例（スレッド投稿対応版）

完全な実行例（起動→cron設定→テスト指示→完了処理）は以下を参照: scripts/full-execution-example.js

応用と拡張

他のプロジェクトでの使用

# プロジェクトディレクトリを変更
cd /path/to/your/project && claude --agent qa-engineer --dangerously-skip-permissions

異なるテストタイプ

• 単体テスト: qa-engineerに単体テスト実行を指示
• 統合テスト: qa-engineerに統合テスト実行を指示
• パフォーマンステスト: qa-engineerにパフォーマンステスト実行を指示

結果分析の自動化

// テスト完了後の自動処理
const results = process("log", sessionId, {limit: 100});
if (results.includes("テスト完了")) {
  // レポート生成・Slack通知・課題抽出など
}

---

まとめ

このスキルにより：

• 確実なE2E自動実行: 権限・停止問題を事前回避
• 効率的な監視: 人手介入なしで長時間実行
• トラブル対応: 典型的問題への自動対処
• 適切な進捗報告: スレッド投稿でチャンネルを荒らさない
• スムーズな後続作業: レポートファイルパス＋要約で修正作業に直結
• 自動完了処理: テスト完了検知から結果投稿まで完全自動化
• 再現可能性: 同じ手順で安定した結果

完了後のワークフロー:

1. テスト完了自動検知
2. エビデンスフォルダからレポートファイル特定
3. レポート要約の自動抽出
4. スレッドに詳細投稿（ファイルパス＋要約＋問題有無）
5. 問題発見時は即座に修正作業へ移行可能

重要: E2Eテストは複雑な処理のため、必ず監視体制とセットで実行すること。

よくある落とし穴

• background で E2E テストを実行する: ブラウザ操作を伴うテストは background 実行では失敗する。必ず pty=true でリアルタイム実行すること
• --dangerously-skip-permissions を付け忘れる: 権限チェックのたびにテストが停止し、手動承認待ちになる。E2E テストでは権限スキップが最も確実
• 監視 cron なしで長時間実行する: 権限待ち・停止状態が放置され、何時間も無駄になる。必ず 2 分おきの監視 cron をセットする
• 進捗報告をチャンネル本文に直接投稿する: cron の監視報告を本文に投稿するとチャンネルが荒れる。開始メッセージのスレッドに投稿すること
• エージェント名の大文字小文字を間違える: qa-engineer が正確な名前。大文字混じりだと認識されない