AI Skills
use-my-browser

use-my-browser

當工作依賴使用者的即時瀏覽器工作階段或可見的渲染狀態，而非靜態擷取時使用，特別適用於瀏覽器除錯情境或 DevTools 選取的元素或請求、已登入的儀表板或 CMS 流程、localhost 應用程式、表單、上傳、下載、媒體檢查、DOM 或 iframe 檢查、Shadow DOM，或看起來像軟 404、驗證牆、反機器人檢查或速率限制的瀏覽器失敗。

65星標
6分支
更新於 2026/6/14
獲取技能源代碼

相關技能

dbs-good-question8134flutter-implement-json-serialization2525github1538
SKILL.md
readonlyread-only
name
use-my-browser
description

當工作依賴使用者的即時瀏覽器工作階段或可見的渲染狀態，而非靜態擷取時使用，特別適用於瀏覽器除錯情境或 DevTools 選取的元素或請求、已登入的儀表板或 CMS 流程、localhost 應用程式、表單、上傳、下載、媒體檢查、DOM 或 iframe 檢查、Shadow DOM，或看起來像軟 404、驗證牆、反機器人檢查或速率限制的瀏覽器失敗。

請勿將此技能視為通用的瀏覽預設值。根據你需要的證據來決定路線，而非根據工具偏好。

每個任務在選擇路線前都必須分類：

  • static-capable：不需要即時瀏覽器狀態、可見確認或頁面互動即可產生證據
  • browser-required：證據依賴於渲染狀態、互動、即時工作階段行為或瀏覽器專屬結構

只有 static-capable 的任務可以回退到靜態擷取、curl 或其他非瀏覽器路徑。一旦任務被歸類為 browser-required，就必須堅持瀏覽器路徑，並將缺少的能力標記為 blocked，而不是默默地降級。

先決條件檢查

此技能用於使用者的即時瀏覽器工作階段內，而非啟動一個獨立的全新自動化瀏覽器。

在執行瀏覽器自動化之前，請確認你的環境已經可以存取一個能提供任務所需能力的即時瀏覽器堆疊，例如頁面清單、任務擁有的頁面建立、頁面選取、快照或可見狀態讀取、DOM 檢查、文字或表單輸入、上傳、對話框、主控台檢查和網路檢查。確切的堆疊不重要：確認能力，而非品牌。

如果即時瀏覽器堆疊不可用，請勿透過此技能嘗試瀏覽器自動化。只有 static-capable 的工作可以回退到靜態擷取。

即時瀏覽器自動化可能會在某些網站觸發反機器人或反自動化防禦。僅在任務真正需要時才使用瀏覽器互動，並在取得所需證據後避免不必要的重複動作。

經驗循環

將網站模式視為瀏覽器協定的一部分，而非可選的背景閱讀。

對於 browser-required 的工作，執行以下循環：

  1. 一旦知道目標網域，立即檢查 references/site-patterns/ 下是否已有相符的筆記。
  2. 如果存在筆記，在對該網域進行第一次有意義的瀏覽器變更之前先閱讀它。
  3. 在執行過程中，留意那些會改變未來執行方式的已驗證網站特定事實。
  4. 在認為任務完成之前，判斷本次執行是否產生了可重複使用的事實、否定了現有事實，或沒有產生可重複使用的網站特定學習。
  5. 如果執行驗證了某些可重複使用的內容或否定了現有聲明，請在完成前更新相符的筆記。

不要為一次性雜訊建立網域筆記。不要因為任務本身成功就跳過執行結束時的審查。

當執行驗證了以下任何一項時，預期需要回寫：

  • 穩定的路由形狀或必要的查詢參數
  • 登入、工作階段繼承或 isolatedContext 的異常
  • 可靠的操作原語，例如懸停、鍵盤輸入、上傳順序或選擇器橋接模式
  • DOM 生成的連結可靠但手動建立的 URL 不可靠的網域
  • 可預測的反自動化摩擦或誤導性的平台錯誤狀態
  • 可重複使用的媒體提取或 iframe / Shadow DOM 存取模式

決策指南

從結果開始，而非工具。明確使用者的目標，定義什麼算完成，並選擇能產生正確證據的最便宜路線。

使用以下路由順序：

  1. 決定任務是 static-capable 還是 browser-required。
  2. 如果任務是 static-capable，載入 references/task-routing.md 並堅持使用能滿足證據目標的最便宜路線。
  3. 如果任務是 browser-required，載入 references/browser-playbook.md。
  4. 如果在新的主機工作階段中不確定瀏覽器所需的能力，也載入 references/browser-capability-matrix.md。
  5. 如果使用者已有活躍的瀏覽器除錯上下文，例如選取的檢查器元素或網路請求，也載入 references/debug-handoff.md。
  6. 如果 browser-required 任務涉及已登入的儀表板、管理介面、CMS、編輯器或任何儲存/發布/更新流程，也載入 references/control-plane-workflows.md。
  7. 如果當前的失敗模式暗示軟 404、內容不可用狀態、可疑的無操作互動、驗證牆、速率限制或反自動化防禦，也載入 references/anti-automation-friction.md。
  8. 如果 browser-required 任務包含 iframe、Shadow DOM、折疊內容或延遲載入的證據，也載入 references/deep-dom.md。
  9. 如果重要的證據存在於圖片、音訊片段或影片中，也載入 references/media-inspection.md。
  10. 如果瀏覽器工作可以分配給獨立的頁面擁有者或子代理，也載入 references/parallel-browser-ownership.md。
  11. 如果你已經知道一個可靠的選擇器但需要 MCP 原生的 uid 目標，也載入 references/selector-bridge.md。
  12. 如果頁面動作留下模糊的狀態、頁面意外導航、舊的 uid 可能已過時，或現在需要主控台/網路檢查來解釋下一個瀏覽器決策，也載入 references/browser-recovery.md。
  13. 如果目標網站已經在 references/site-patterns/ 下有相符的網域筆記，在操作該網站前先閱讀該筆記。

預設將以下情況視為 browser-required：

  • localhost、127.0.0.1 或基準測試風格的本地測試環境
  • 上傳、下載、拖放、懸停、鍵盤原生輸入或可見確認狀態
  • 同源 iframe 檢查、Shadow DOM 檢查、details / 折疊證據或延遲載入內容
  • 任何「頁面可見顯示的內容」本身就是證據的任務

常見任務的正常快樂路徑是此入口點加上一兩個參考文件，而非整個參考文件集。

嚴格規則

  • 僅在即時瀏覽器狀態是證據或必要動作的一部分時才使用瀏覽器互動。
  • 一旦任務被歸類為 browser-required，請勿默默地降級。
  • 將此檔案視為入口點，每個參考文件視為單一用途的權威。請勿跨檔案重複規則。
  • 保持參考載入深度為一層。從此入口點決定下一個檔案，而不是將一個參考變成連結更多參考的中心。
  • 不要僅僅因為頁面看起來受限就要求使用者登入。首先確認目標內容或動作是否真的被封鎖。
  • 一旦頁面顯示了它期望的路徑，優先使用網站生成的 DOM 連結而非手動建立的 URL。
  • 當任務確實是瀏覽器內的動作時，優先使用 MCP 原生動作而非腳本驅動的互動。
  • 只關閉你建立的頁面。
  • 優先使用主要來源而非聚合器或重複的次要報告。
  • 如果存在相符的網站模式筆記，在對該網域進行第一次有意義的瀏覽器變更之前先閱讀它。
  • 在完成 browser-required 任務之前，務必明確檢查本次執行是否應建立、更新、降級或移除網站模式聲明。
  • 如果現有的網站模式聲明在可比條件下失敗，停止信任它，回退到通用工作流程，並更新筆記，而不是重試過時的假設。
  • 請勿對 browser-required 任務使用 curl、Invoke-WebRequest 或 shell HTTP 擷取。
  • 不要將通用的頁面開啟工具視為 localhost 深度互動可用的證據。
  • 不要僅僅因為瀏覽器能力探測失敗就切換路線。記錄缺少的能力並停止。
  • 當使用者指示活躍的瀏覽器除錯上下文時，優先從該當前上下文交接，而非從頭開始重新產生。

參考索引