技能包

給程式設計代理先裝 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,以該頁為準。第一次不要對生產站點做自動化。