Screenshot

• 디버깅, QA, 문서화, 버그 리포트, 릴리스 노트 또는 시각적 검토를 위해 Screenshot이 필요한 경우.
• 데스크톱 앱, 브라우저 페이지, 시뮬레이터 출력 또는 헤드리스 CI 환경에서 작업하며 결정론적이고 재현 가능한 캡처가 필요한 경우.
• 안정적인 before/after 비교가 필요하고 뷰포트 크기, 줌 레벨, 테마 및 애니메이션 상태를 제어해야 하는 경우.
• 레이아웃이 안정되기 전에 캡처하거나, 민감한 정보가 노출되거나, 플랫폼에 맞지 않는 도구를 사용하는 것(예: 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의 안정성 기능을 활용합니다: 고정된 뷰포트, 애니메이션 비활성화, 커서 숨김, 그리고 민감한 영역 마스킹.

기준 캡처와 비교 캡처 전반에 걸쳐 일관된 뷰포트 크기, 줌 레벨, 디바이스 배율, 테마(라이트/다크)를 강제 적용합니다. 실행 간 환경 변화로 인해 발생하는 무의미한 diff를 방지합니다.

셔터가 작동하기 전에 불안정한 UI 요소(커서, 캐럿, 토스트 메시지, 타임스탬프, 알림, 무작위 콘텐츠)와 비밀 정보, 토큰, 개인 데이터를 숨기거나 마스킹하도록 에이전트를 안내합니다.

UI, 코드 및 텍스트가 많은 캡처의 경우 기본적으로 PNG를 사용합니다. Screenshot에 JPEG를 사용하는 것은 명시적으로 권장하지 않으며(텍스트와 가장자리가 흐려짐), 수신자가 지원하는 경우 공유 목적으로 WebP를 허용 가능한 형식으로 취급합니다.

실패 즉시 재시도 전에 Screenshot을 저장하고, 기준선(baseline)에는 안정적인 파일명을 사용하며 임시 캡처에는 타임스탬프를 활용하고, 헤드리스 환경에서는 호스트 디스플레이 캡처보다 브라우저 네이티브 Screenshot을 선호하도록 규정합니다.

버그를 재현할 때, 이 스킬은 적절한 도구(예: 웹 앱의 경우 Playwright)를 선택하고, 손상된 UI 상태가 완전히 렌더링될 때까지 기다린 후, 사이드바나 URL에 포함된 민감한 데이터를 마스킹하고, 안정적인 파일명으로 PNG를 저장합니다 — 이를 통해 보고자와 검토자 모두에게 즉시 활용 가능한 증거를 생성합니다.

CI 파이프라인에서 이 스킬은 뷰포트를 고정하고, 애니메이션을 비활성화하며, 요소 또는 클리핑된 영역의 Screenshot을 기준선(baseline)으로 캡처합니다. 이후 실행 시에도 동일한 설정을 적용하여, 환경적 노이즈가 아닌 실제 UI 변경 사항만 diff에 반영되도록 합니다.

xcrun simctl io booted screenshot을 사용하여 시뮬레이터 프레임을 안정적으로 캡처합니다. 이를 통해 데스크톱 Screenshot 도구가 시뮬레이터의 실제 출력 버퍼 대신 시뮬레이터 창을 캡처할 때 발생하는 아티팩트를 방지할 수 있습니다.

고정된 뷰포트로 '변경 전' Screenshot을 캡처하고, UI 변경 사항을 적용한 다음, 동일한 확대/축소 수준, 테마 및 상태로 '변경 후' Screenshot을 동일하게 캡처합니다. 이를 통해 풀 리퀘스트 검토나 사용자 대상 문서화에 적합한 깔끔한 비교 자료를 생성합니다.