playwright

Playwright CLI スキル

playwright-cli を使って、端末から実ブラウザを操作します。CLI がグローバルインストールされていなくても動くよう、同梱のラッパースクリプトを優先してください。 このスキルは CLI ベースの自動操作を前提にします。ユーザーがテストファイルを明示的に求めない限り、@playwright/test へ切り替えないでください。

前提確認（必須）

コマンドを提案する前に、npx が利用可能か確認します（ラッパーが依存しています）。

command -v npx >/dev/null 2>&1

利用できない場合は、そこで止めて Node.js/npm（npx を含む）のインストールをユーザーに依頼します。次の手順をそのまま案内してください。

# Node/npm が入っているか確認
node --version
npm --version

# もし無ければ Node.js/npm を入れ、その後:
npm install -g @playwright/cli@latest
playwright-cli --help

npx が使えるなら、そのままラッパースクリプトを利用します。playwright-cli のグローバルインストールは任意です。

スキルのパス（一度だけ設定）

export CODEX_HOME="${CODEX_HOME:-$HOME/.codex}"
export PWCLI="$CODEX_HOME/skills/playwright/scripts/playwright_cli.sh"

ユーザー単位でインストールしたスキルは $CODEX_HOME/skills 配下に置かれます（デフォルトは ~/.codex/skills）。

クイックスタート

ラッパースクリプトを使います。

"$PWCLI" open https://playwright.dev --headed
"$PWCLI" snapshot
"$PWCLI" click e15
"$PWCLI" type "Playwright"
"$PWCLI" press Enter
"$PWCLI" screenshot

ユーザーがグローバルインストールを望むなら、こちらでも構いません。

npm install -g @playwright/cli@latest
playwright-cli --help

基本ワークフロー

1. ページを開く。
2. スナップショットを取り、安定した要素参照を得る。