setup-browser-cookies

setup-browser-cookies 技能概覽

setup-browser-cookies 的用途

setup-browser-cookies 技能可協助 agent 將真實 Chromium 瀏覽器中的 cookies 匯入到無頭瀏覽工作階段。它特別適合需要先取得已登入狀態、才能開始測試的驗證型 QA 與瀏覽器自動化工作。

誰應該安裝它

如果你經常需要下列情境，就應該安裝 setup-browser-cookies 技能：

• 測試登入後頁面
• 重現驗證流程中的 bug
• 把真實瀏覽器工作階段交接給自動化流程
• 避免每次執行都手動重建驗證狀態

這個技能有什麼不同

不同於只會說「先登入」的通用提示，setup-browser-cookies 多了明確的 cookie 匯入流程與互動式選擇步驟。當你需要精準控制哪些網域會被帶進無頭工作階段時，這一點就很重要；不是只給一個模糊的驗證指令而已。

什麼情況最適合使用

setup-browser-cookies for Browser Automation 最適合的情境，是瀏覽器狀態已經存在於 Chromium，而你的主要工作是安全地重用它。如果你需要完整輸入帳密、處理 MFA，或從零開始建立全新的驗證流程，這個技能就沒那麼合適。

如何使用 setup-browser-cookies 技能

安裝這個技能

依照你環境中的 repo 技能安裝流程操作，然後確認系統中已可使用 setup-browser-cookies 這個名稱。如果你的環境有 skill manager，先安裝套件，再確認 skill 目錄內包含 SKILL.md 與 SKILL.md.tmpl。

從正確的任務提示開始

當你的需求清楚說明需要哪種已驗證的瀏覽器狀態時，這個技能效果最好。好的輸入會明確寫出：

• 目標網站或應用程式
• 登入後要執行的任務
• 你要全部 cookies 還是只要特定網域
• 任何瀏覽器限制，例如只能使用 Chromium

更強的提示範例如下：Use setup-browser-cookies to import my Chromium cookies for example.com, then open the dashboard and verify the billing page loads as an authenticated user.

先讀哪些內容

在你依賴 setup-browser-cookies usage 流程之前，先檢查：

• SKILL.md：確認實際操作步驟
• SKILL.md.tmpl：了解這個 skill 如何生成，以及哪些內容應該保持穩定
• 說明 preamble、safe operations、skill routing 的段落

這些內容比通讀整份檔案更重要，因為它們會告訴你這個 skill 什麼時候該執行，以及它對工作階段有什麼前提。

實務工作流程建議

為了得到更好的結果，請明確告訴 agent：

• 哪個瀏覽器設定檔或哪台機器存放 cookies
• 是否預期會有多個網域驗證
• 如果 cookie picker 顯示太多網域，應該怎麼處理
• 目標是只讀驗證，還是會進行會改動資料的操作

如果任務描述太模糊，這個技能可能會匯入錯誤網域，或過早停止。請直接說明你在意哪些已驗證頁面，而不只是網站名稱。

setup-browser-cookies 技能 FAQ

setup-browser-cookies 只支援 Chromium 嗎？

它的設計重點是把真實 Chromium 瀏覽器中的 cookies 匯入無頭工作階段。如果你的瀏覽器狀態存放在別處，除非你的流程本來就能銜接，否則這個技能可能不是最佳選擇。

我還需要提供登入資料嗎？

如果已經存在有效的瀏覽器工作階段，通常不需要。setup-browser-cookies 技能的目的，是重用已驗證狀態，而不是用輸入帳密去取代應用程式本來的登入流程。

這會比一般只說「登入」的提示更好嗎？

會，前提是瓶頸在於工作階段重用。一般提示可以要求登入行為，但 setup-browser-cookies install 會提供可重複使用的 cookie 匯入模式，也能更清楚地觸發已驗證的瀏覽器工作。

什麼情況下不該使用它？

以下情況不要使用：

• 需要建立新帳號流程
• 需要密碼重設步驟
• 需要手動進行 MFA 註冊
• 需要非 Chromium 的工作階段轉移

在這些情況下，較適合用更通用的瀏覽器自動化技能，或針對任務撰寫專用的登入提示。

如何改進 setup-browser-cookies 技能

給技能正確的工作階段目標

最有效的改進通常來自更精準的工作階段定位，而不是加更多指令。請明確寫出網站、已驗證路徑，以及匯入後 agent 應該在哪個點停下來。這能減少 cookies 載入後的猜測。

減少 cookie 範圍的歧義

如果你的環境跨越多個子網域，請說明哪些才重要。例如：import cookies for app.example.com and api.example.com, but ignore marketing domains. 這樣可以避免匯入無關網域，導致工作階段變得雜亂或混淆。

預先處理最常見的失敗模式

最常見的失敗，是驗證狀態不完整：頁面雖然打開了，但仍顯示登入牆、工作階段過期，或只有部分權限可用。發生這種情況時，請把匯入後看到的內容、失敗的網域，以及瀏覽器設定檔是否原本就有有效工作階段，更新到提示裡。

用成果導向的回饋持續迭代

第一次執行後，請根據你希望 agent 驗證的結果來調整任務：

• confirm the account menu shows the logged-in user
• open the admin page and check that the session persists
• if import fails, ask before retrying with a different domain set

這類回饋會讓 setup-browser-cookies guide 更有效，而不是只是重述原本的目標。