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 格式。明确不建议对 Screenshot 使用 JPEG 格式（会模糊文字和边缘），并在接收方支持的情况下，将 WebP 视为可接受的分享格式。

规定在重试之前立即在失败时保存 Screenshot，对基准图像使用稳定的文件名，对临时截图使用时间戳命名，并在无头环境中优先使用浏览器原生 Screenshot，而非主机显示截图。

在复现错误时，该技能会选择合适的工具（例如，针对 Web 应用使用 Playwright），等待异常 UI 状态完全渲染，对侧边栏或 URL 中的敏感数据进行遮罩处理，并以稳定的文件名保存为 PNG 格式——从而生成对报告者和审查者均立即可用的证据。

在 CI 流水线中，该技能会固定视口、禁用动画，并捕获元素或裁剪区域的 Screenshot 作为基准。在后续运行时，它会应用相同的设置，从而确保差异反映的是真实的 UI 变化，而非环境噪声。

使用 xcrun simctl io booted screenshot 可靠地捕获模拟器画面，避免桌面 Screenshot 工具直接抓取模拟器窗口（而非其实际输出缓冲区）时产生的图像失真问题。

捕获固定视口的"前"Screenshot，应用界面更改后，以相同的缩放比例、主题和状态捕获完全一致的"后"Screenshot——生成简洁的对比图，适用于拉取请求审查或面向用户的文档。