Screenshot

• Vous avez besoin de captures d'écran pour le débogage, l'assurance qualité, la documentation, les rapports de bugs, les notes de version ou la revue visuelle.
• Vous travaillez avec des applications de bureau, des pages de navigateur, des sorties de simulateur ou des environnements CI headless et avez besoin de captures déterministes et reproductibles.
• Vous avez besoin de comparaisons avant/après stables et devez contrôler la taille de la fenêtre d'affichage, le niveau de zoom, le thème et l'état des animations.
• Vous souhaitez éviter les pièges courants tels que capturer avant que la mise en page ne soit stabilisée, laisser fuiter des informations sensibles ou utiliser le mauvais outil pour la plateforme (par exemple, les outils X11 sous Wayland).

• Vous devez modifier, annoter, rogner, compresser ou reformater une image après la capture — utilisez plutôt la compétence image-edit ou image.
• Vous devez enregistrer un flux en plusieurs étapes sous forme de vidéo plutôt qu'un Screenshot statique — utilisez plutôt la compétence video.
• La tâche concerne uniquement l'automatisation du navigateur ou l'interaction avec le DOM au-delà de la capture de Screenshot — utilisez plutôt la compétence playwright.

Recommande le meilleur outil de capture selon le contexte : screencapture pour macOS, xcrun simctl pour le simulateur iOS, grim+slurp pour Linux Wayland, scrot pour X11/CI sans interface graphique, Playwright pour les pages web, et nircmd/Pillow pour Windows. Privilégie par défaut l'approche la plus native avant de recourir à des outils plus lourds.

Indique à l'agent d'attendre l'inactivité du réseau, des éléments spécifiques ou un état explicite de l'interface utilisateur avant de capturer — sans jamais effectuer de pause aveugle. Pour les captures de navigateur, il exploite les fonctionnalités de stabilité de Playwright : fenêtre d'affichage fixe, animations désactivées, curseur masqué et régions sensibles occultées.

Impose une taille de fenêtre d'affichage, un niveau de zoom, une échelle d'appareil et un thème (clair/sombre) cohérents entre les captures de référence et de comparaison. Évite les différences insignifiantes causées par une dérive environnementale entre les exécutions.

Guide l'agent pour masquer ou dissimuler les éléments d'interface instables — curseurs, carets, notifications éphémères, horodatages, alertes et contenus aléatoires — ainsi que les secrets, jetons et données personnelles avant le déclenchement de Screenshot.

Par défaut au format PNG pour les captures d'interfaces utilisateur, de code et de contenu textuel dense. Déconseille explicitement le format JPEG pour les Screenshot (qui floute le texte et les contours) et considère le WebP comme acceptable pour le partage lorsque le destinataire le prend en charge.

Prescrit d'enregistrer un Screenshot immédiatement en cas d'échec avant toute nouvelle tentative, d'utiliser des noms de fichiers stables pour les références de base et des horodatages pour les captures ponctuelles, et de privilégier les Screenshot natifs du navigateur plutôt que les captures de l'affichage hôte dans les environnements sans interface graphique.

Lors de la reproduction d'un bug, la compétence sélectionne l'outil approprié (par exemple, Playwright pour une application web), attend que l'état défaillant de l'interface soit entièrement affiché, masque toutes les données sensibles présentes dans les barres latérales ou les URL, et enregistre un PNG avec un nom de fichier stable — produisant ainsi des preuves immédiatement exploitables par le rapporteur et le réviseur.

Dans un pipeline CI, la compétence fixe la fenêtre d'affichage, désactive les animations et capture des Screenshot d'éléments ou de régions recadrées comme références de base. Lors des exécutions suivantes, elle applique les mêmes paramètres afin que les différences reflètent de véritables changements d'interface, et non des variations liées à l'environnement.

Utilise xcrun simctl io booted screenshot pour capturer une image du simulateur de manière fiable, en évitant les artefacts qui apparaissent lorsque les outils de Screenshot du bureau capturent la fenêtre du simulateur au lieu de son tampon de sortie réel.

Capture un Screenshot « avant » à viewport fixe, applique une modification d'interface, puis capture un Screenshot « après » identique avec le même zoom, le même thème et le même état — produisant une comparaison claire, adaptée aux revues de pull request ou à la documentation destinée aux utilisateurs.