Screenshot

• Вам нужны скриншоты для отладки, контроля качества, документации, отчётов об ошибках, заметок о выпуске или визуальной проверки.
• Вы работаете с настольными приложениями, браузерными страницами, выводом симулятора или средами CI без графического интерфейса и нуждаетесь в детерминированных, воспроизводимых захватах.
• Вам нужны стабильные сравнения «до/после» и необходимо контролировать размер области просмотра, уровень масштабирования, тему и состояние анимации.
• Вы хотите избежать распространённых ловушек, таких как захват до завершения отрисовки макета, утечка секретов или использование неподходящего инструмента для платформы (например, инструментов X11 в Wayland).

• Вам нужно редактировать, аннотировать, обрезать, сжимать или изменять формат изображения после захвата — используйте вместо этого навык image-edit или image.
• Вам нужно записать многошаговый процесс в виде видео, а не статичного Screenshot — используйте вместо этого навык video.
• Задача связана исключительно с автоматизацией браузера или взаимодействием с DOM, выходящим за рамки захвата Screenshot — используйте вместо этого навык playwright.

Рекомендует оптимальный инструмент захвата в зависимости от контекста: screencapture для macOS, xcrun simctl для iOS Simulator, grim+slurp для Linux Wayland, scrot для X11/headless CI, Playwright для веб-страниц и nircmd/Pillow для Windows. По умолчанию использует наиболее нативный путь, прежде чем прибегать к более тяжёлым инструментам.

Инструктирует агента ожидать сетевого простоя, появления конкретных элементов или явного состояния пользовательского интерфейса перед захватом — без бездумных задержек через sleep. Для захвата в браузере используются функции стабилизации Playwright: фиксированный viewport, отключённые анимации, скрытый курсор и маскирование чувствительных областей.

Обеспечивает согласованный размер области просмотра, уровень масштабирования, масштаб устройства и тему (светлую/тёмную) при базовых и сравнительных захватах. Предотвращает бессмысленные различия, вызванные изменением среды между запусками.

Направляет агента скрывать или маскировать нестабильные элементы интерфейса — курсоры, каретки, всплывающие уведомления, временны́е метки, оповещения и случайно генерируемый контент, — а также секреты, токены и персональные данные до того, как Screenshot выполнит захват.

По умолчанию используется PNG для захвата интерфейса, кода и текстовых материалов. Явно не рекомендуется использовать JPEG для Screenshot (размывает текст и края), тогда как WebP считается приемлемым для публикации, если получатель его поддерживает.

Предписывает сохранять Screenshot немедленно при сбое перед повторной попыткой, использовать стабильные имена файлов для базовых снимков и временны́е метки для разовых захватов, а также отдавать предпочтение нативным Screenshot браузера перед захватом хост-дисплея в headless-окружениях.

При воспроизведении ошибки навык выбирает подходящий инструмент (например, Playwright для веб-приложения), ожидает полной отрисовки некорректного состояния интерфейса, скрывает конфиденциальные данные в боковых панелях или URL-адресах и сохраняет PNG с устойчивым именем файла — создавая доказательство, которое сразу же пригодится как автору отчёта, так и проверяющему.

В CI-пайплайне навык фиксирует область просмотра, отключает анимации и делает Screenshot элементов или обрезанных областей в качестве базовых снимков. При последующих запусках применяются те же настройки, поэтому различия отражают реальные изменения интерфейса, а не шум окружения.

Использует xcrun simctl io booted screenshot для надёжного захвата кадра симулятора, позволяя избежать артефактов, которые возникают при использовании стандартных инструментов создания Screenshot рабочего стола вместо обращения к реальному буферу вывода симулятора.

Делает Screenshot фиксированного окна просмотра в состоянии «до», применяет изменение интерфейса, затем делает идентичный Screenshot в состоянии «после» с тем же масштабом, темой и состоянием — создавая чистое сравнение, подходящее для проверки pull request или пользовательской документации.