Screenshot

• Hai bisogno di screenshot per debug, QA, documentazione, segnalazioni di bug, note di rilascio o revisione visiva.
• Stai lavorando con app desktop, pagine browser, output di simulatori o ambienti CI headless e hai bisogno di acquisizioni deterministiche e riproducibili.
• Hai bisogno di confronti stabili prima/dopo e devi controllare le dimensioni del viewport, il livello di zoom, il tema e lo stato delle animazioni.
• Vuoi evitare trappole comuni come acquisire prima che il layout si stabilizzi, esporre segreti o usare lo strumento sbagliato per la piattaforma (ad esempio, strumenti X11 su Wayland).

• Devi modificare, annotare, ritagliare, comprimere o riformattare un'immagine dopo l'acquisizione — usa invece la skill image-edit o image.
• Devi registrare un flusso multi-step come video anziché come Screenshot statico — usa invece la skill video.
• Il compito riguarda esclusivamente l'automazione del browser o l'interazione con il DOM al di là dell'acquisizione di Screenshot — usa invece la skill playwright.

Raccomanda il miglior strumento di acquisizione in base al contesto: screencapture per macOS, xcrun simctl per iOS Simulator, grim+slurp per Linux Wayland, scrot per X11/CI headless, Playwright per le pagine web e nircmd/Pillow per Windows. Privilegia il percorso più nativo prima di ricorrere a strumenti più pesanti.

Indica all'agente di attendere il riposo della rete, elementi specifici o uno stato esplicito dell'interfaccia utente prima di acquisire — senza mai ricorrere a pause cieche. Per le acquisizioni tramite browser, sfrutta le funzionalità di stabilità di Playwright: viewport fisso, animazioni disabilitate, cursore nascosto e regioni sensibili mascherate.

Impone dimensioni del viewport, livello di zoom, scala del dispositivo e tema (chiaro/scuro) coerenti tra le acquisizioni di riferimento e quelle di confronto. Previene differenze prive di significato causate da variazioni ambientali tra un'esecuzione e l'altra.

Guida l'agente a nascondere o mascherare elementi dell'interfaccia instabili — cursori, caret, toast, timestamp, notifiche e contenuti randomizzati — nonché segreti, token e dati personali prima che venga scattato il Screenshot.

Il formato predefinito è PNG per acquisizioni di interfacce utente, codice e testo. Sconsiglia esplicitamente l'uso di JPEG per gli Screenshot (sfoca testo e bordi) e considera WebP accettabile per la condivisione quando il destinatario lo supporta.

Prescrive di salvare uno Screenshot immediatamente al momento del fallimento prima di riprovare, di utilizzare nomi di file stabili per le baseline e timestamp per le acquisizioni ad hoc, e di preferire gli Screenshot nativi del browser rispetto all'acquisizione del display host in ambienti headless.

Durante la riproduzione di un bug, la skill seleziona lo strumento più adatto (ad esempio, Playwright per un'applicazione web), attende che lo stato dell'interfaccia difettosa venga completamente renderizzato, maschera eventuali dati sensibili nelle barre laterali o negli URL, e salva uno Screenshot in formato PNG con un nome file stabile — producendo una prova immediatamente utile per chi segnala il problema e per chi lo revisiona.

In una pipeline CI, la skill fissa il viewport, disabilita le animazioni e acquisisce Screenshot di elementi o regioni ritagliate come baseline. Nelle esecuzioni successive applica le stesse impostazioni, in modo che le differenze riflettano reali cambiamenti dell'interfaccia utente e non variazioni ambientali.

Utilizza xcrun simctl io booted screenshot per acquisire un fotogramma del simulatore in modo affidabile, evitando gli artefatti che compaiono quando gli strumenti di Screenshot del desktop catturano la finestra del simulatore anziché il suo buffer di output effettivo.

Cattura uno Screenshot a viewport fisso del "prima", applica una modifica all'interfaccia utente, quindi cattura uno Screenshot identico del "dopo" con lo stesso zoom, tema e stato — producendo un confronto pulito adatto per le revisioni delle pull request o per la documentazione rivolta agli utenti.