name: frontend-verify description: agent-browserを使用したフロントエンド実装の検証スキル。UI実装後の動作確認、インタラクションテスト、アクセシビリティ確認に使用。「フロントエンドを検証」「UIを確認」「/frontend-verify」「画面の動作確認」などで使用。UI実装完了時に自律的にトリガーする。
Frontend Verify
agent-browserを使用してローカル開発サーバーのフロントエンドを検証するスキル。
前提条件
- 開発サーバーが起動していること(
pnpm dev) agent-browserがインストール済み
基本ワークフロー
1. サーバー接続確認
agent-browser open http://localhost:3000
接続エラー時は開発サーバーの起動を促す。
2. スナップショット取得
agent-browser snapshot -i
インタラクティブ要素のアクセシビリティツリーを取得。出力例:
@e1 button "ログイン"
@e2 input[type="email"] placeholder="メールアドレス"
@e3 input[type="password"] placeholder="パスワード"
3. スクリーンショット取得
agent-browser screenshot --full /tmp/verify-$(date +%s).png
4. インタラクション実行
refを使って操作:
agent-browser fill @e2 "test@example.com"
agent-browser fill @e3 "password123"
agent-browser click @e1
5. 結果確認
agent-browser wait --load networkidle
agent-browser snapshot -i
agent-browser screenshot /tmp/result.png
使用シナリオ
基本検証(引数なし)
/frontend-verify
http://localhost:3000へアクセス- スナップショット取得
- フルページスクリーンショット取得
- 結果を報告
パス指定検証
/frontend-verify /auth/signup
http://localhost:3000/auth/signupへアクセス- スナップショット取得
- スクリーンショット取得
- フォーム要素を特定して報告
インタラクティブ検証
/frontend-verify --interact
- ページへアクセス
- スナップショットから操作可能な要素を特定
- ユーザーに操作シナリオを確認
- シナリオを実行(例:フォーム入力→送信→結果確認)
- 各ステップでスクリーンショット取得
主要コマンド(クイックリファレンス)
| 操作 | コマンド |
|---|---|
| ページ移動 | open <url> |
| スナップショット | snapshot -i |
| スクリーンショット | screenshot [--full] <path> |
| クリック | click <ref> |
| 入力 | fill <ref> <text> |
| 待機 | wait --text "..." / --load networkidle |
| 状態確認 | is visible <ref> |
詳細は references/agent-browser-commands.md を参照。
セッション管理
複数ステップの検証では同一セッションを維持:
export AGENT_BROWSER_SESSION="verify-session"
agent-browser open http://localhost:3000/auth/login
agent-browser fill @e1 "user@example.com"
agent-browser fill @e2 "password"
agent-browser click @e3
agent-browser wait --load networkidle
agent-browser snapshot -i # ログイン後の状態を確認
エラーハンドリング
| エラー | 対応 |
|---|---|
| 接続エラー | 「開発サーバーを起動してください: pnpm dev」 |
| 要素が見つからない | スナップショットを再取得してrefを確認 |
| タイムアウト | wait コマンドで明示的に待機 |
/rams との使い分け
| スキル | 用途 |
|---|---|
/frontend-verify | 詳細な動作検証、インタラクションテスト、デバッグ |
/rams | アクセシビリティ・ビジュアルデザインのレビュー |
UI実装後は両方を実行することを推奨:
/frontend-verifyで動作確認/ramsでデザイン・アクセシビリティレビュー