Screenshot

• Tarvitset kuvakaappauksia virheenkorjaukseen, laadunvarmistukseen, dokumentaatioon, vikaraportteihin, julkaisutiedotteisiin tai visuaaliseen tarkistukseen.
• Työskentelet työpöytäsovellusten, selainssivujen, simulaattorilähdön tai headless CI -ympäristöjen kanssa ja tarvitset deterministisiä, toistettavia kaappauksia.
• Tarvitset vakaita ennen/jälkeen-vertailuja ja sinun täytyy hallita näkymän kokoa, zoomaustasoa, teemaa ja animaatiotilaa.
• Haluat välttää yleisiä sudenkuoppia, kuten kaappaamista ennen kuin asettelu on vakiintunut, salaisuuksien vuotamista tai väärän työkalun käyttämistä alustalle (esim. X11-työkalut Waylandilla).

• Sinun täytyy muokata, merkitä, rajata, pakata tai muuttaa kuvan muotoa kaappauksen jälkeen — käytä sen sijaan image-edit- tai image-taitoa.
• Sinun täytyy tallentaa monivaiheinen kulku videona eikä pysäytyskuvana — käytä sen sijaan video-taitoa.
• Tehtävä koskee pelkästään selainautomaatiota tai DOM-vuorovaikutusta Screenshot-kaappauksen ulkopuolella — käytä sen sijaan playwright-taitoa.

Suosittelee parasta kaappaustyökalua kontekstin mukaan: screencapture macOS:lle, xcrun simctl iOS-simulaattorille, grim+slurp Linux Waylandille, scrot X11/headless CI -ympäristöille, Playwright verkkosivuille sekä nircmd/Pillow Windowsille. Käyttää oletuksena natiiviinta vaihtoehtoa ennen raskaampiin työkaluihin turvautumista.

Ohjaa agentin odottamaan verkon toimettomuutta, tiettyjä elementtejä tai eksplisiittistä käyttöliittymän tilaa ennen kaappaamista — ei koskaan sokeasti nukkuen. Selainkaappauksia varten se hyödyntää Playwrightin vakausominaisuuksia: kiinteä näkymäportti, poistetut animaatiot, piilotettu kohdistin ja peitetyt arkaluonteiset alueet.

Varmistaa yhdenmukaisen näkymäportin koon, zoomaustason, laitteen skaalauksen ja teeman (vaalea/tumma) perus- ja vertailukuvausten välillä. Estää ympäristömuutosten aiheuttamat merkityksettömät erot ajojen välillä.

Ohjaa agentin piilottamaan tai peittämään epävakaat käyttöliittymäelementit — kursorit, tekstikohdistimet, ilmoituspopupit, aikaleima, ilmoitukset ja satunnaistuva sisältö — sekä salaisuudet, tunnukset ja henkilökohtaiset tiedot ennen Screenshot-toiminnon laukaisemista.

Oletusarvoisesti käytetään PNG-muotoa käyttöliittymä-, koodi- ja tekstipainotteisissa kuvissa. JPEG-muotoa ei suositella Screenshot-kuviin (sumentaa tekstiä ja reunoja), ja WebP-muoto hyväksytään jakamista varten, kun vastaanottava sovellus tukee sitä.

Määrää tallentamaan Screenshot heti epäonnistumisen yhteydessä ennen uudelleenyritystä, käyttämään vakaita tiedostonimiä lähtötilanteen kuville ja aikaleimoja tilapäisille kuvakaappauksille sekä suosimaan selaimen omia Screenshot-ominaisuuksia isäntänäytön kaappauksen sijaan näytöttömissä ympäristöissä.

Kun bugia toistetaan, taito valitsee sopivan työkalun (esim. Playwright web-sovellukselle), odottaa rikkinäisen käyttöliittymätilan täyttä latautumista, peittää mahdolliset arkaluonteiset tiedot sivupalkeissa tai URL-osoitteissa ja tallentaa PNG-kuvan vakaalla tiedostonimellä — tuottaen todistusaineistoa, joka on välittömästi hyödyllistä sekä raportoijalle että tarkastajalle.

CI-putkessa taito kiinnittää näkymäportin, poistaa animaatiot käytöstä ja ottaa elementti- tai rajatun alueen Screenshot-kuvia peruslinjoiksi. Myöhemmillä ajoilla se soveltaa samoja asetuksia, jotta erot heijastavat todellisia käyttöliittymämuutoksia eivätkä ympäristöhäiriöitä.

Käyttää komentoa xcrun simctl io booted screenshot simulaattorin kuvakaappauksen luotettavaan ottamiseen, välttäen virheet, joita ilmenee kun työpöydän kuvakaappaustyökalut kaappaavat simulaattorin ikkunan sen todellisen tulostuspuskurin sijaan.

Ottaa kiinteän näkymäportin "ennen"-Screenshot-kuvan, soveltaa käyttöliittymämuutoksen, ja ottaa sen jälkeen identtisen "jälkeen"-Screenshot-kuvan samalla zoomilla, teemalla ja tilalla — tuottaen selkeän vertailun, joka sopii pull request -arviointeihin tai käyttäjille suunnattuun dokumentaatioon.