安裝
npx skills add https://github.com/currents-dev/playwright-best-practices-skill適合誰
這份指南面向正在用 TypeScript 編寫、除錯或維護 Playwright 測試，並希望智能體按目前活動給出針對性建議的人。官方把它寫成活動驅動：你在做什麼，它就指向對應參考，而不是一次裝入全部材料。
儲存庫見
https://github.com/currents-dev/playwright-best-practices-skill
它適合儲存庫裡已經有 Playwright 測試、你要修不穩定用例或補充無障礙測試的時候。材料寫明不必說出技能名稱或 “Playwright best practices”，把任務講清楚即可。
它不適合主要寫其他語言測試、或沒有相容技能安裝機制的環境。現有材料只把指導範圍寫在 TypeScript 的 Playwright 測試上，不要據此推廣到未寫明的語言。
3 分鐘完成第一次嘗試
只走官方推薦的一條路徑。
前置條件：本機可執行 npx，目前智能體相容這種技能安裝方式，並且工作區裡有一份可討論的 Playwright 測試。執行安裝前，確認你要寫入的是正在使用的智能體環境。
安裝位置：由 npx skills add 自行處理。材料沒有寫出目標資料夾，不要手補未出現的路徑。
複製並執行：
npx skills add https://github.com/currents-dev/playwright-best-practices-skill
成功訊號：命令正常結束。先做一次只讀檢查：打開一份登入相關測試，對智能體說「看一下這個不穩定的登入測試，先指出可能原因，不要改檔案」。官方例子正是 “fix this flaky login test”。若回覆引用了具體等待、選取或斷言問題，而不是空泛重寫，說明對應參考已被用到。
分析可接受後，你再明確授權它改哪個檔案。改測試是有副作用的操作，確認範圍之前不要讓它直接打補丁。
使用案例
案例一：排查不穩定的登入測試。對應官方示例任務 “fix this flaky login test”。適合測試有時過、有時不過，你希望先得到聚焦建議。先描述現象和失敗日誌，要求只分析。成功時，回覆應落到目前活動相關的參考，而不是把全部 57 篇文件一股腦倒出來。材料沒有列出八個分類的名稱，因此不要編造分類或文件檔名。真正修改測試前，先確認要動的檔案和預期行為。
案例二：補充無障礙測試。對應官方示例 “add accessibility tests”。適合你已有頁面流程，想加上無障礙檢查。先讓智能體根據目前頁面測試列出建議斷言，仍先不寫檔案。你確認選擇器和涵蓋範圍後，再讓它新增用例。成功訊號是建議能對應你指定的頁面，而不是通用範本。現有材料只證明可以按這個任務描述觸發，沒有展開具體 API 或設定項。
使用邊界
現有材料只給出一條安裝命令，以及「按活動指向參考」的用法。不要改用未出現的市場命令、複製路徑或其他安裝器。材料也沒有點名必須支援的用戶端，不要把某幾個智能體寫成獨家支援。
參考庫規模是 57 篇、分成 8 類，但分類名稱和單篇路徑都沒有寫出來。不要發明文件路徑或技能子目錄。
它指導的是 TypeScript 裡的 Playwright 測試寫作、除錯與維護。其他語言、或其他測試框架的步驟不能從現有材料補全。改測試會改儲存庫；先分析、再授權寫入。更多說明以官方儲存庫為準：
https://github.com/currents-dev/playwright-best-practices-skill