菜单
Web アプリの E2E テストを「計画 → 実行 → エビデンス保存 → 後始末」まで自律的に進めるための skill。グローバルの agent-browser CLI を headless で使い、quality-mind の共通品質観点（正常系、境界値、ドメイン外値、悪意ある異常系、状態整合性、リグレッション）に沿ってブラウザ操作と検証を行い、確認結果をスクリーンショットとして ./tmp/e2e/ 配下にエビデンスとして残す。認証が必要なアプリの動作確認、フォーム投入・バリデーションの検証、リリース前の通し確認をするときに使う。単体テストや read-only のコード調査だけで完結するとき、ブラウザ操作を伴わないときは使わない。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
日本語の応答を、明瞭・簡潔・LLM 口調なしで書くための規範。会話、説明、提案、相談のすべてで適用する。
説明的な文章に緩急を設計するための規範。緩急を装飾ではなく認知モードの切替（観察→逡巡→断定→再観察）と未回収の緊張の管理として扱い、文の拍、段落の密度波形、節の入り方、緩みと駄文の判別、執筆後の機械的な点検手順を定める。読み物として読ませたい章・記事・解説文を生成するとき、または「密度はあるが平坦でおもしろくない」文章を診断・修正するときに使用する。
UI・フロントエンドの実装・修正・レビューで必ず使う skill。画面、コンポーネント、フォーム、ダイアログ、スタイル、文言、状態管理、UX を扱うときに、既存デザインシステムの再利用、i18n、操作性の定番作法、再レンダリング、日本語入力(IME)の観点で判断する。バックエンドのみ・CLI のみの作業では使わない。
Final pre-commit, pre-push, or pre-merge verification for implementation work. Use when Codex needs to confirm the change satisfies the user's request before committing, pushing, opening, updating, or merging a PR; when asked for a final check; or when PR-linked context such as issues, review comments, CI checks, changed files, and acceptance criteria must be verified against the implementation.
コードの実装・修正・リファクタリングを行うすべての作業で必ず使う skill。書き始める前に「正しい置き場所」「既存の同種実装」「本質的な解決策」を確認し、フォールバック、ハードコード、スタブ、名前文字列による分岐、指示されていない互換レイヤーといった対症療法を検知して排除する。責務分離、命名、ファイル分割、破壊的変更の要否など設計判断にも使う。read-only の調査・説明だけで完結するときは使わない。
仕様を決める・機能を切る・UX を判断する・優先順位を提案する・仕様の妥当性をレビューするときに必ず使う skill。実装依頼に仕様の曖昧さが含まれるとき、エラー時の振る舞いを決めるとき、フェーズやスコープを切るとき、機能提案を求められたときに使う。仕様が完全に確定していて実装するだけのときは軽く通す。
| name | automatic-e2e |
| description | Web アプリの E2E テストを「計画 → 実行 → エビデンス保存 → 後始末」まで自律的に進めるための skill。グローバルの agent-browser CLI を headless で使い、quality-mind の共通品質観点（正常系、境界値、ドメイン外値、悪意ある異常系、状態整合性、リグレッション）に沿ってブラウザ操作と検証を行い、確認結果をスクリーンショットとして ./tmp/e2e/ 配下にエビデンスとして残す。認証が必要なアプリの動作確認、フォーム投入・バリデーションの検証、リリース前の通し確認をするときに使う。単体テストや read-only のコード調査だけで完結するとき、ブラウザ操作を伴わないときは使わない。 |
| allowed-tools | Bash(*) |
Web アプリの E2E テストを、再現可能・エビデンス付きの形で一貫して実施するための workflow。
ブラウザ操作はグローバルの agent-browser CLI を使い、テスト計画・認証情報・スクリーンショットは ./tmp/e2e/ のブランチ領域に残す。次回以降も変わらない知見（認証情報の所在、対象 URL、観点の学び）は memory（MEMORY.md）にも適宜記載して再利用する。
agent-browser CLI を使う（agent-browser / npx agent-browser）。これは invoke できる skill ではなくコマンドラインツール。コマンド一覧は agent-browser --help か .agents/skills/agent-browser/SKILL.md を参照する。agent-browser はデフォルト headless だが、環境変数 AGENT_BROWSER_HEADED や config の "headed": true で headed になり得る。GUI ウィンドウが立ち上がってユーザーの作業を妨げないよう、起動コマンドに必ず --headed false を明示し、AGENT_BROWSER_HEADED を設定しない。./tmp/e2e/<branch>/ 配下に置く。ブランチslug等の特定は同梱スクリプトが行う。quality-mind を正とする。自動で併用されていない場合は .agents/skills/quality-mind/SKILL.md または .agents/.private/quality-mind/SKILL.md を読み、共通観点をテスト計画へ反映する。この skill ディレクトリ内の scripts/ を使う（パスはこの skill からの相対）。
# 1. ワークスペース初期化（ブランチslug 解決 + エビデンスdir リセット + 計画ファイル seed）
# slug 解決済みのパスを変数に取り込む（EVIDENCE_DIR / HOW_TO_FILE が定義される）
eval "$(bash scripts/init-e2e.sh | grep -E '^(EVIDENCE_DIR|HOW_TO_FILE)=')"
# 2. ブラウザ操作は必ず headless 強制ラッパー ab.sh 経由で実行する
# 保存先は手で <branch> を埋めず、上で得た "$EVIDENCE_DIR" をそのまま使う
bash scripts/ab.sh --session e2e-normal open https://app.example.com
bash scripts/ab.sh --session e2e-normal screenshot --screenshot-dir "$EVIDENCE_DIR"
# 3. 終了時に必ず後始末（全セッションを閉じ、残プロセスを確認）
bash scripts/finish-e2e.sh
同梱スクリプト:
scripts/init-e2e.sh — ブランチ領域を初期化。HOW_TO_E2E_TEST.md を seed し、エビデンスdir を毎回リセットする（回し直し＝1から取り直しを自動担保）。scripts/ab.sh — agent-browser の headless 強制ラッパー。AGENT_BROWSER_HEADED を unset し --headed false を必ず注入するので、GUI ウィンドウが立ち上がらない。ブラウザ操作は必ずこれ経由で行う。scripts/finish-e2e.sh — 全セッションを閉じ、残プロセスを確認する。.env、設定ファイル、docs 等）を探す。確保した認証情報は次回ヒアリング不要にするため HOW_TO_E2E_TEST.md（後述）に記録する。
確認すべき仕様を事前に洗い出し、quality-mind の共通観点を E2E で確認可能な操作に落とす。
リポジトリに言語設定（i18n 等）の仕組みがある場合は、日本語と別の言語（デフォルトは英語）の両軸で確認する。
quality-mind の共通観点を実施する。./tmp/e2e/<branch>/HOW_TO_E2E_TEST.md にまとめ、次回から参照できるようにする。./tmp/ が消えても復元できるようにする。scripts/ab.sh 経由で実行する。--headed false が常に注入され、GUI ウィンドウが立ち上がらない。素の agent-browser を直接叩かない。--session <name>（例: --session e2e-normal）でセッションを分け、プロセス・状態を独立させる。ユーザーから特段の指示がなければ、各ステップごとに docker logs を確認する。
各操作のあとにブラウザ側のエラーを必ず確認する。
agent-browser errors でページエラー、agent-browser console でコンソールメッセージを確認する。E2E 操作後、確認可能な範囲で quality-mind の状態整合性観点を確認する。
仕様に関連する箇所・異常系・状態整合性・リグレッションの確認では、必ずスクリーンショットを撮ってエビデンスとして格納する。
init-e2e.sh が用意・リセットした e2e-evidence/。パスは手で <branch> を埋めず、init-e2e.sh が出力する EVIDENCE_DIR（クイックスタート参照）をそのまま使う。
例: bash scripts/ab.sh --session e2e-normal screenshot --screenshot-dir "$EVIDENCE_DIR"normal_login_ok.png、abnormal_invalid_email.png、regression_dashboard.png。i18n がある場合は言語も含める: en_normal_login_ok.png）。init-e2e.sh がエビデンスdir のリセットで自動的に担保する。 手動でスクショを消す必要はないが、過去実行のスクショを残したまま混在させないこと。複数観点を並行してテストする場合は、観点ごとに子エージェントへ割り振る。
--session <name> で独立した agent-browser セッションを使い、プロセスを共有しない。scripts/finish-e2e.sh を実行して全セッションを閉じ、残プロセスがないことを確認する。HOW_TO_E2E_TEST.md が ./tmp/e2e/<branch>/ に揃っていることを確認し、次回以降に再利用すべき知見があれば memory を更新する。