スキル

コーディングエージェントには先に Playwright CLI を入れ、それからテスト足場を語る

先に公式 Playwright CLI をグローバル導入し、同じ API で三大ブラウザエンジンを駆動する。最初はテスト案件一式を初期化しない。

公式ソース · microsoft/playwright

インストール

npm i -g @playwright/cli@latest

誰向けか

この技能は、同じ API で Chromium、Firefox、WebKit を駆動したい人に合う。公式はウェブ自動化とテストの枠組みと書き、テスト、スクリプト、コーディングエージェントの道具にも使える。すでに Claude Code や Copilot のようなコーディングエージェントを使い、公式コマンドラインを入れる準備がある人にも合う。この二つの名は原文の例であり、それらだけが対応だと読んではならない。

まだグローバルインストールに同意していないのに、テスト案件一式をすぐ生成したい人には合わない。公式には別途 npm init playwright@latest があり、テスト案件を初期化する。最初はこの経路を歩かない。先にエージェントにコマンドラインを使わせたいなら、主経路は @playwright/cli のグローバル導入である。

公式リポジトリは https://github.com/microsoft/playwright そのページにすでに書かれたコマンドで操作する。

3分で最初の試みを終える

公式がコーディングエージェント向けに書いたこの導入経路だけを歩く。

前提:本機で npm を実行でき、グローバル導入を一度はっきり同意している。先に確認する:npm i -g @playwright/cli@latest はコマンドラインをグローバルに入れる。まだ本機のグローバルパッケージを変えたくないなら実行しない。この段階ではテスト案件を初期化せず、実在サイトも開かない。

インストール位置:任意の端末で上記の副作用を確認してから実行する:

npm i -g @playwright/cli@latest

低リスク照合:導入後、まずエージェントに公式説明だけからこの CLI の用途を復唱させる。コーディングエージェント向けのブラウザ自動化コマンドラインと書かれ、MCP より token を省き、大きなツールスキーマとアクセシビリティツリーをモデル文脈へ載せない。ブラウザを起動しない。外部サイトへ要求を送らない。より厚いエージェント統合を後で入れたいなら、原文に playwright-cli install --skills もある。それはスキルファイルを書くので、実行前にもう一度確認する。

成功の合図:グローバル導入が終わり、エージェントが主コマンドは @playwright/cli だと指せ、出ていないインストーラに切り替えていない。直接 npm init playwright@latest を走らせたら経路を間違えている。止まる。

使用事例

事例一:コーディングエージェントに公式 CLI を入れる。原文は Claude Code、Copilot の傍に npm i -g @playwright/cli@latest を書き、続いて playwright-cli install --skills でより厚いエージェント統合を入れてよい。先にコマンドラインが欲しく、スキルファイルを書くかは後で決める人に合う。二本目のコマンドはローカルのスキルディレクトリを変える。実行前に確認する。

事例二:エンドツーエンドのテスト案件を新しく作る。公式コマンドは npm init playwright@latest。テスト足場が欲しいとすでに決め、案件ファイルを作ることに同意した人に合う。初期化はディスクへ書く。まだコマンドラインを試したいだけのときに実行しない。原文にブラウザダウンロードのスイッチがなければ、引数を自分で補わない。

使用の境界

主経路は npm i -g @playwright/cli@latest。出ていないインストーラを主経路に書かない。playwright-cli install --skills と npm init playwright@latest は原文の別の二本であり、用途が違う。一本に混ぜない。

能力は同じ API で Chromium、Firefox、WebKit を駆動し、テスト、スクリプト、コーディングエージェントに使う。名指しされていないブラウザエンジンを駆動できることは証明していない。Claude Code、Copilot は見本の一覧にすぎない。

公式ページは https://github.com/microsoft/playwright エージェントが勧める最初のコマンドが @playwright/cli のグローバル導入でないなら、当該ページを正とする。最初に本番サイトへ自動化をかけない。