Screenshot

• デバッグ、QA、ドキュメント、バグレポート、リリースノート、またはビジュアルレビューのためにScreenshotが必要な場合。
• デスクトップアプリ、ブラウザページ、シミュレーター出力、またはヘッドレスCI環境を扱っており、決定論的で再現性のあるキャプチャが必要な場合。
• 安定したビフォー/アフターの比較が必要で、ビューポートサイズ、ズームレベル、テーマ、およびアニメーションの状態を制御しなければならない場合。
• レイアウトが安定する前にキャプチャする、シークレットを漏洩させる、またはプラットフォームに適していないツールを使用する（例：Wayland上でX11ツールを使用する）といった一般的な落とし穴を避けたい場合。

• キャプチャ後に画像を編集、注釈追加、トリミング、圧縮、またはフォーマット変換する必要がある場合は、代わりに image-edit または image スキルを使用してください。
• 静止画のScreenshotではなく、複数ステップのフローをビデオとして録画する必要がある場合は、代わりに video スキルを使用してください。
• タスクがScreenshotのキャプチャを超えたブラウザの自動操作やDOM操作に関するものである場合は、代わりに playwright スキルを使用してください。

コンテキストごとに最適なキャプチャツールを推奨します：macOS には screencapture、iOS シミュレーターには xcun simctl、Linux Wayland には grim+slurp、X11/ヘッドレス CI には scrot、ウェブページには Playwright、Windows には nircmd/Pillow を使用します。より重いツールに頼る前に、最もネイティブなパスをデフォルトとして選択します。

エージェントに対して、キャプチャを行う前にネットワークのアイドル状態、特定の要素、または明示的なUI状態が整うまで待機するよう指示します。やみくもにスリープさせることはありません。ブラウザキャプチャでは、Playwrightの安定化機能を活用します：固定ビューポート、アニメーションの無効化、キャレットの非表示、および機密領域のマスク処理。

ベースラインと比較キャプチャ間で、一貫したビューポートサイズ、ズームレベル、デバイススケール、およびテーマ（ライト/ダーク）を強制します。実行間の環境的なズレによって生じる無意味な差分を防ぎます。

エージェントに対して、シャッターが切られる前に、不安定なUI要素（カーソル、キャレット、トースト通知、タイムスタンプ、通知、ランダムに変化するコンテンツなど）、およびシークレット情報、トークン、個人データを非表示またはマスクするよう案内します。

UIやコード、テキストが多いキャプチャにはデフォルトでPNGを使用します。Screenshotに対してJPEGは明示的に推奨されません（テキストやエッジがぼやけるため）。WebPは、受信側がサポートしている場合に共有用として許容されるフォーマットとして扱われます。

障害発生時にリトライの前に即座にScreenshotを保存し、ベースライン用には安定したファイル名を、アドホックなキャプチャにはタイムスタンプを使用し、ヘッドレス環境ではホストディスプレイのキャプチャよりもブラウザネイティブのScreenshotを優先することを規定します。

バグを再現する際、このスキルは適切なツール（例：ウェブアプリに対してPlaywright）を選択し、壊れたUIの状態が完全にレンダリングされるまで待機します。その後、サイドバーやURLに含まれる機密データをマスクし、安定したファイル名でPNGとして保存します。これにより、報告者とレビュアーがすぐに活用できる証跡が生成されます。

CIパイプラインでは、このスキルがビューポートを固定し、アニメーションを無効化し、要素またはクリップ領域のScreenshotをベースラインとしてキャプチャします。以降の実行でも同じ設定を適用するため、差分は環境的なノイズではなく、実際のUI変更を正確に反映します。

xcrun simctl io booted screenshot を使用してシミュレータのフレームを確実にキャプチャします。デスクトップのScreenshotツールがシミュレータの実際の出力バッファではなくウィンドウを直接撮影した場合に生じるアーティファクトを回避できます。

固定ビューポートで「変更前」のScreenshotを撮影し、UIの変更を適用した後、同じズーム・テーマ・状態で「変更後」の同一Screenshotを撮影します。これにより、プルリクエストのレビューやユーザー向けドキュメントに適した、きれいな比較画像を生成できます。