agent-device

Utilisez cette compétence comme un routeur avec des paramètres par défaut obligatoires. Lisez d'abord ce fichier. Pour les tâches de dispositif normales, chargez toujours references/bootstrap-install.md et references/exploration.md avant d'agir. Utilisez bootstrap pour confirmer ou établir une configuration déterministe. Utilisez exploration pour l'inspection d'interface, l'interaction et la vérification une fois la session d'application ouverte.

Règles de fonctionnement par défaut

Commencez prudemment. Préférez l'inspection en lecture seule avant de modifier l'interface.
Utilisez snapshot simple quand la tâche consiste à vérifier quel texte ou quelle structure est actuellement visible à l'écran.
Utilisez snapshot -i uniquement quand vous avez besoin de références interactives comme @e3 pour une action demandée ou une requête ciblée.
Évitez les mutations spéculatives. Vous pouvez effectuer la plus petite action d'interface réversible nécessaire pour débloquer l'inspection ou terminer la tâche demandée, comme fermer une popup, fermer une alerte ou effacer une surface non souhaitée.
Ne naviguez pas sur le web et n'utilisez pas de sources externes sauf si l'utilisateur le demande explicitement.
Re-snapshottez après les changements d'interface significatifs au lieu de réutiliser des références obsolètes.
Préférez le ciblage @ref ou selector aux coordonnées brutes.
Assurez-vous que la cible correcte est épinglée et une session d'application ouverte avant d'interagir.
Gardez la boucle courte : open -> inspecter/agir -> vérifier si nécessaire -> close.

Flux par défaut

Chargez references/bootstrap-install.md et references/exploration.md avant d'agir sur une tâche de dispositif normale.
Utilisez d'abord bootstrap pour confirmer ou établir la cible correcte, l'installation de l'application et l'ouverture de la session d'application.
Une fois la session d'application ouverte et stable, utilisez exploration pour l'inspection, l'interaction et la vérification.
Commencez par snapshot simple si l'objectif est de lire ou vérifier ce qui est visible.
Escaladez vers snapshot -i uniquement si vous avez besoin de références pour l'exploration interactive ou une action demandée.
Utilisez get, is ou find avant de modifier l'interface quand une commande en lecture seule peut répondre à la question.
Terminez en capturant une preuve si nécessaire, puis close.

Modes QA

Chasse aux bugs ouverte avec rapport : utilisez ../dogfood/SKILL.md.
QA pass/fail à partir de critères d'acceptation : restez dans cette compétence, commencez par references/bootstrap-install.md, puis utilisez la boucle QA dans references/exploration.md.

Références obligatoires

Pour chaque tâche de dispositif normale, après avoir lu ce fichier, chargez d'abord references/bootstrap-install.md, puis references/exploration.md, avant d'agir.
Utilisez bootstrap pour confirmer ou établir une configuration déterministe, en particulier dans les environnements sandbox ou cloud.
Utilisez exploration une fois la session d'application ouverte et stable.
Chargez les références supplémentaires uniquement quand leur portée est nécessaire.

Règles de décision

Utilisez snapshot simple quand vous devez vérifier si un texte est visible.
Utilisez snapshot -i principalement pour l'exploration interactive et le choix de références.
Utilisez get, is ou find quand ils peuvent répondre à la question sans changer l'état de l'interface.
Utilisez fill pour remplacer du texte.
Utilisez type pour ajouter du texte.
Quand une tâche demande de « revenir en arrière », utilisez back simple pour la navigation prévisible gérée par l'application et réservez back --system pour les gestes de retour de la plateforme ou la sémantique des boutons.
Utilisez type --delay-ms ou fill --delay-ms pour les champs de recherche en débit contrôlé qui perdent des caractères quand ils sont saisis trop rapidement.
S'il n'y a pas de simulateur, pas d'installation d'application ou pas de session d'application ouverte encore, basculez vers bootstrap-install.md au lieu d'improviser des étapes de configuration.
Utilisez la plus petite action de déblocage d'abord quand une interface transitoire bloque l'inspection, mais ne naviguez pas, ne recherchez pas ou n'entrez pas de nouveau texte juste pour faire apparaître des données à moins que l'utilisateur ait demandé cette interaction.
N'utilisez pas de recherches externes pour compenser les données manquantes à l'écran sauf si l'utilisateur l'a demandé.
Si les informations nécessaires ne sont pas exposées à l'écran, dites-le clairement au lieu de compenser avec une navigation supplémentaire, une saisie de texte ou une recherche web.
Préférez le ciblage @ref ou selector aux coordonnées brutes.

Références supplémentaires

Avez-vous besoin de logs, réseau, alertes, permissions ou triage de défaillance : references/debugging.md
Avez-vous besoin de captures d'écran, diff, enregistrement, maintenance de relecture ou données de performance : references/verification.md
Avez-vous besoin de surfaces desktop, comportement de barre de menu ou règles d'interaction spécifiques à macOS : references/macos-desktop.md
Avez-vous besoin de transport HTTP distant, lancements --remote-config ou baux de locataires sur un hôte macOS distant : references/remote-tenancy.md