用途:当用户明确要求桌面或系统截图(全屏、指定应用/窗口、活动窗口或像素区域),或专用截图工具无法干净地获取目标时,使用本技能进行操作系统级截图。
主要能力:按请求分类为全屏、指定应用/窗口、活动窗口或像素区域;解析保存位置;优先使用工具专用截图能力(如 Figma MCP/技能、Playwright/agent-browser 等),否则调用随附的平台辅助脚本。支持 macOS、Linux、Windows,并提供直接系统命令作为回退。
使用方式:macOS/Linux 运行 python3 <path-to-skill>/scripts/take_screenshot.py,常用参数包括 --mode temp、--path、--app、--window-name、--list-windows、--region x,y,w,h、--active-window、--window-id。Windows 运行 powershell -ExecutionPolicy Bypass -File <path-to-skill>/scripts/take_screenshot.ps1,参数包括 -Mode、-Path、-Region、-ActiveWindow、-WindowHandle。macOS 窗口/应用截图前先运行 bash <path-to-skill>/scripts/ensure_macos_permissions.sh 检查并申请屏幕录制权限。
保存规则:用户指定路径则保存到该路径;用户未指定路径则保存到系统默认截图位置;Codex 自身检查用截图保存到临时目录。
限制与注意:--app、--window-name、--list-windows 仅限 macOS;Linux 需 scrot、gnome-screenshot 或 ImageMagick import,坐标区域依赖 scrot 或 import;macOS 多显示器全屏截图每个显示器生成一个文件,Linux/Windows 全屏为虚拟桌面单图;多文件输出需按顺序查看并报告全部路径;始终返回所用截图模式、保存路径及重要注意事项。