agent-browser スキル設計書

Appearance

セットアップ ​

前提条件 ​

  • macOS / Linux
  • Node.js 18 以降（npm 経由のインストール時のみ）

インストール ​

自動インストール（推奨） ​

bash
# スキルのインストールスクリプトを実行
bash /path/to/agent-browser/scripts/install.sh

手動インストール ​

bash
# 1. agent-browser CLI のインストール
npm install -g agent-browser

# 2. Chrome for Testing のダウンロード
agent-browser install

# 3. 動作確認
agent-browser --version

代替インストール方法 ​

bash
# Homebrew
brew install agent-browser
agent-browser install

# Cargo (Rust)
cargo install agent-browser
agent-browser install

環境チェック ​

bash
# ヘルスチェックスクリプトで確認
bash /path/to/agent-browser/scripts/health-check.sh

出力例:

[health-check] agent-browser CLI: OK (v0.24.1)
[health-check] Chrome for Testing: OK (~/.agent-browser/browsers/chrome-...)
[health-check] Playwright fallback: OK (npx playwright available)
[health-check] All checks passed

dev-workflow との統合 ​

1. スキルパスの登録 ​

親プロジェクトの CLAUDE.md にスキルを追加:

markdown
| agent-browser | Rust製ブラウザ自動化CLIによるE2Eテスト高速化 | `/path/to/agent-browser/SKILL.md` |

2. config.toml の設定 ​

toml
[browser]
engine = "agent-browser"    # デフォルトエンジン
headless = true

[fallback]
playwright_fallback = true  # 未インストール時のフォールバック

3. 動作確認 ​

bash
# テスト用URLでE2Eテスト実行
agent-browser open https://example.com --viewport 1400x900
agent-browser screenshot /tmp/test.png
agent-browser close

# エビデンス確認
open /tmp/test.png

トラブルシューティング ​

agent-browser install が失敗する ​

bash
# Chrome for Testing のダウンロード先を確認
ls ~/.agent-browser/browsers/

# 手動でChrome for Testingをダウンロード
agent-browser install --force

デーモンが起動しない ​

bash
# デーモンの状態確認
agent-browser session list

# デーモンを手動起動
AGENT_BROWSER_DAEMON=1 agent-browser

# ログ確認
agent-browser --debug open https://example.com

Playwrightフォールバックが効かない ​

bash
# Playwrightのインストール確認
npx playwright --version

# 未インストールの場合
npm install --no-save playwright
npx playwright install chromium