Screenshot

• 您需要截圖以用於除錯、品質保證、文件撰寫、錯誤回報、版本說明或視覺審查。
• 您正在處理桌面應用程式、瀏覽器頁面、模擬器輸出或無頭 CI 環境，並需要具有確定性、可重現的截圖捕捉。
• 您需要穩定的前後對比，並且必須控制視窗大小、縮放級別、佈景主題和動畫狀態。
• 您希望避免常見陷阱，例如在版面配置穩定前就進行截圖、洩漏機密資訊，或在特定平台上使用錯誤的工具（例如在 Wayland 上使用 X11 工具）。

• 您需要在擷取後編輯、標註、裁剪、壓縮或重新格式化圖片——請改用 image-edit 或 image 技能。
• 您需要將多步驟流程錄製為影片而非靜態 Screenshot——請改用 video 技能。
• 任務純粹涉及瀏覽器自動化或超出 Screenshot 擷取範圍的 DOM 互動——請改用 playwright 技能。

根據不同情境推薦最佳擷取工具：macOS 使用 screencapture、iOS 模擬器使用 xcrun simctl、Linux Wayland 使用 grim+slurp、X11/無頭 CI 環境使用 scrot、網頁使用 Playwright，以及 Windows 使用 nircmd/Pillow。在採用較重量級工具之前，預設優先使用最原生的途徑。

指示代理程式在擷取前等待網路閒置、特定元素或明確的 UI 狀態，而非盲目地進行等待休眠。針對瀏覽器擷取，它會運用 Playwright 的穩定性功能：固定視窗大小、停用動畫、隱藏游標，以及遮蔽敏感區域。

強制在基準擷取與比較擷取之間保持一致的視窗大小、縮放層級、裝置縮放比例及主題（淺色／深色）。防止因多次執行之間的環境差異而產生無意義的差異比對結果。

引導代理程式在快門觸發前，隱藏或遮蔽不穩定的 UI 元素——包括游標、插入號、Toast 通知、時間戳記、通知訊息與隨機內容——以及機密資訊、存取權杖與個人資料。

預設使用 PNG 格式，適用於 UI、程式碼及文字密集的擷圖。明確不建議對 Screenshot 使用 JPEG（會模糊文字和邊緣），並在接收方支援的情況下，將 WebP 視為可接受的分享格式。

規定在重試之前，應於失敗發生時立即儲存 Screenshot；基準圖使用穩定的檔案名稱，臨時擷取則使用時間戳記命名；並在無頭環境中優先採用瀏覽器原生 Screenshot，而非主機顯示器擷取。

在重現錯誤時，此技能會選擇適合的工具（例如，針對網頁應用程式使用 Playwright），等待異常的 UI 狀態完整渲染，遮蔽側邊欄或網址列中的任何敏感資料，並以穩定的檔案名稱儲存 PNG 檔案——產出對回報者與審閱者而言立即可用的證據。

在 CI 流程中，此技能會固定視窗大小、停用動畫，並擷取元素或裁切區域的 Screenshot 作為基準線。在後續執行時套用相同設定，確保差異比對反映的是真實的 UI 變更，而非環境干擾所造成的雜訊。

使用 xcrun simctl io booted screenshot 可靠地擷取模擬器畫面，避免桌面 Screenshot 工具直接擷取模擬器視窗（而非其實際輸出緩衝區）時所產生的影像瑕疵。

擷取固定視窗的「之前」Screenshot，套用 UI 變更後，再以相同的縮放比例、佈景主題與狀態擷取一張相同的「之後」Screenshot — 產生乾淨清晰的對比結果，適合用於 Pull Request 審查或面向使用者的文件記錄。