playwright-skill 是做什麼的？
重要 - 路徑解析： 此技能可安裝於不同位置（外掛系統、手動安裝、全域或專案特定）。在執行任何指令前，請根據載入此 SKILL.md 檔案的位置判斷技能目錄，並於以下所有指令中使用該路徑。
概述
sickn33/playwright-skill 提供 Playwright 瀏覽器自動化功能，讓 AI 代理能夠在開發與測試流程中執行端對端測試及網頁互動。
功能
- 瀏覽器控制 – 啟動 Chromium、Firefox 或 WebKit 瀏覽器。
- 網頁導航 – 造訪 URL 並等待頁面載入。
- 元素互動 – 點擊、輸入文字、選取選項及更多操作。
- 測試撰寫 – 建立可重複使用的端對端測試案例。
- 螢幕擷取 – 擷取頁面或元素截圖。
安裝
使用外掛系統（若受支援）
# 路徑範例：~/.claude/skills/sickn33-playwright-skill/
手動安裝
git clone https://github.com/sickn33/playwright-skill.git
cd playwright-skill
npm install
npx playwright install
全域安裝（位於系統層級）
# 路徑範例：/usr/local/share/skills/sickn33-playwright-skill/
專案特定安裝
# 將技能置於專案目錄中，例如 ./skills/
設定
建立 .env 檔案或設定環境變數：
PLAYWRIGHT_SKILL_DIR=/path/to/skill/directory
若未指定，技能會嘗試自動偵測路徑，但顯式設定可確保可靠性。
使用方式
基本瀏覽器測試
from playwright.sync_api import sync_playwright
with sync_playwright() as p:
browser = p.chromium.launch(headless=False)
page = browser.new_page()
page.goto("https://example.com")
print(page.title())
browser.close()
CLI 快速執行
cd /path/to/skill
npx playwright test --headed
專案結構
playwright-skill/
├── SKILL.md
├── package.json
├── tests/
│ └── example.spec.js
├── scripts/
│ └── run.js
└── README.md
疑難排解
- 路徑錯誤 – 確認
PLAYWRIGHT_SKILL_DIR環境變數已設定，或根據載入 SKILL.md 的位置手動提供正確路徑。 - 瀏覽器遺失 – 執行
npx playwright install以下載所需瀏覽器。 - 權限問題 – 確保技能目錄對執行使用者具有讀寫權限。
授權
MIT