using-screenshots

Par microsoft · fluidframework

Utilisez ceci pour capturer le contexte de l'écran.

npx skills add https://github.com/microsoft/fluidframework --skill using-screenshots

Prendre et analyser des captures d'écran

Aperçu

Tu PEUX prendre des captures d'écran en combinant l'outil Bash avec des commandes spécifiques à la plateforme. Les captures d'écran sont sauvegardées en tant que fichiers image, puis chargées dans ton contexte à l'aide de l'outil Read pour une analyse visuelle.

Quand utiliser

Utilise cette compétence quand je te demande de :

  • « Prendre une capture d'écran »
  • « Regarder mon écran »
  • « Analyser ce bug UI visuellement »
  • « Examiner ce qui s'affiche actuellement »
  • « Capturer et examiner l'interface »

Référence rapide

Plateforme Commande Sélection interactive
macOS screencapture Flag -i (sélection zone)
Linux gnome-screenshot, scrot ou import Flag -a ou -s

Flux de travail standard :

  1. Détecter la plateforme avec uname -s
  2. Vérifier l'outil de capture disponible
  3. Capturer vers /tmp/screenshot_$(date +%s).png
  4. Utiliser l'outil Read avec le chemin du fichier
  5. Analyser l'image
  6. Optionnellement nettoyer le fichier temporaire

Instructions détaillées

1. Détecter la plateforme

uname -s
  • Retourne Darwin pour macOS
  • Retourne Linux pour Linux

2. Vérifier les outils disponibles

macOS : screencapture est toujours disponible (intégré)

Linux : Vérifier dans l'ordre de priorité :

which gnome-screenshot || which scrot || which import || echo "none"

Ordre de priorité (meilleure compatibilité) :

  1. gnome-screenshot - fonctionne sur X11 et Wayland
  2. scrot - léger, X11 uniquement
  3. import - partie de ImageMagick

3. Capturer la capture d'écran

Utiliser un nom de fichier horodaté pour éviter les conflits :

macOS :

screencapture -i /tmp/screenshot_$(date +%s).png
  • -i active la sélection interactive de zone
  • L'utilisateur clique et glisse pour sélectionner la région

Linux avec gnome-screenshot :

gnome-screenshot -af /tmp/screenshot_$(date +%s).png
  • -a pour sélection de zone
  • -f spécifie le nom de fichier

Linux avec scrot :

scrot -s /tmp/screenshot_$(date +%s).png
  • -s active le mode sélection

Linux avec import :

import /tmp/screenshot_$(date +%s).png
  • Fournit un réticule pour la sélection au clic et glissement

4. Charger l'image dans le contexte

Read tool: file_path="/tmp/screenshot_12345.png"

L'outil Read affiche les images visuellement. Tu verras la capture d'écran et pourras l'analyser.

5. Analyser l'image

Une fois chargée, tu peux :

  • Identifier les éléments UI
  • Repérer les bugs visuels
  • Examiner les éléments de design
  • Lire le contenu textuel
  • Analyser les problèmes de mise en page

6. Nettoyage optionnel

rm /tmp/screenshot_12345.png

À ne supprimer que si le fichier n'est plus utile.

Gérer les outils manquants

Si aucun outil de capture n'est disponible sur Linux :

  1. T'en informer quel outil manque

  2. Suggérer l'installation :

    • Ubuntu/Debian : sudo apt install gnome-screenshot
    • Fedora : sudo dnf install gnome-screenshot
    • Arch : sudo pacman -S gnome-screenshot
    • ImageMagick : sudo apt install imagemagick (ou équivalent)
  3. Alternative : Demander à l'utilisateur de prendre manuellement une capture et fournir le chemin

Erreurs courantes

❌ Dire « Je ne peux pas prendre de captures d'écran »

Réalité : Tu PEUX le faire via Bash + outils CLI de capture

❌ Oublier d'utiliser l'outil Read après la capture

Réalité : Le fichier de capture doit être chargé avec l'outil Read pour le voir

❌ Utiliser des chemins relatifs

Réalité : Toujours utiliser des chemins absolus (/tmp/...) pour l'outil Read

❌ Ne pas vérifier les outils disponibles sur Linux

Réalité : Détecter quel outil est installé avant de tenter la capture

Exemple de flux de travail

Utilisateur : « Prendre une capture d'écran et aide-moi à déboguer ce bug UI »

1. Vérifier la plateforme :
   uname -s → Linux

2. Vérifier les outils disponibles :
   which gnome-screenshot → /usr/bin/gnome-screenshot

3. Capturer la capture d'écran :
   gnome-screenshot -af /tmp/screenshot_1729012345.png
   → L'utilisateur sélectionne une zone, fichier sauvegardé

4. Charger dans le contexte :
   Read: file_path="/tmp/screenshot_1729012345.png"
   → L'image s'affiche visuellement

5. Analyser :
   « Je vois que l'alignement du bouton est décalé. Le bouton 'Envoyer'
   est 5px plus bas que le bouton 'Annuler'... »

6. Nettoyage optionnel :
   rm /tmp/screenshot_1729012345.png

Skills similaires