Communitygithub.com

AlphaZero78/browser-question-workflow

Une compétence réutilisable pour Codex afin de réaliser et vérifier de manière fiable des workflows de questions dans un navigateur autorisé.

Qu'est-ce que browser-question-workflow ?

Cette compétence permet à un agent IA (comme Codex) d'opérer la session de navigateur existante de l'utilisateur pour compléter de bout en bout des workflows de questions autorisées. Développée et vérifiée principalement pour U校园 / Unipus, elle traite tous les autres sites comme des adaptations non vérifiées, exigeant une inspection minutieuse de chaque interaction. Elle fonctionne en respectant des règles strictes : utiliser uniquement les réponses fournies par l'utilisateur, ne pas deviner les réponses pour les évaluations notées, préserver la session connectée via Chrome, et ne jamais confondre « visité » ou « répondu » avec « section terminée ». Le workflow se déroule en étapes structurées : inventaire des tâches, inspection de l'état en direct, détermination de la structure de la page, remplissage conservateur des réponses, soumission et vérification de chaque section, gestion des tests et des iframes, récupération après interruption, et audit final. L'efficacité est optimisée via des appels d'inspection uniques, des lectures et écritures DOM groupées, et des opérations courtes et redémarrables. Une section n'est considérée comme complète qu'avec un signal durable (marqueur de complétion, page de résultat affichant le nombre attendu, ou état soumis/enregistré).

Compatible avec~Claude Code✓Codex CLI~Cursor
npx skills add AlphaZero78/browser-question-workflow

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Workflow de questions dans un navigateur

Opérez la session de navigateur existante de l'utilisateur et terminez de bout en bout les workflows de questions autorisées.

Ce workflow est développé et vérifié principalement pour U校园 / Unipus. Traitez tous les autres sites comme des adaptations non vérifiées : inspectez chaque interaction et ne supposez jamais que la soumission ou la détection de complétion est correcte.

Règles

  • Utilisez les réponses fournies par l'utilisateur, un fichier de réponses désigné par l'utilisateur, ou des réponses explicitement révélées par la page.
  • Ne déduisez pas de réponses pour les évaluations notées. Demandez la source de réponse manquante ou laissez ces questions sans réponse.
  • Préservez la session connectée. Préférez le contrôle de Chrome pour l'état Chrome existant.
  • Traitez un clic sur 提交 comme une action nécessitant une autorisation explicite ou déjà donnée par l'utilisateur.
  • Ignorez les types de questions que l'utilisateur a exclus, comme les tâches d'expression orale ou d'enregistrement.
  • N'assimilez jamais « visité », « répondu » ou « soumis une page » à « section terminée ».
  • En dehors de U校园 / Unipus, utilisez des étapes courtes et vérifiez chaque signal d'écriture, de navigation, de soumission et de complétion avant de continuer.

Workflow

  1. Inventorier la tâche

    • Identifiez les unités cibles, les sections, les exclusions, les sources de réponses, et si la soumission est autorisée.
    • Convertissez les réponses en une carte structurée indexée par section et numéro de question.
    • Pour les options randomisées, stockez le texte exact de l'option, pas seulement les lettres.
  2. Inspecter l'état en direct

    • Lisez l'URL, les boutons visibles, les onglets, le nombre de questions, le nombre de champs de saisie, les dialogues, les iframes, et les icônes de complétion.
    • Enregistrez quelles sections sont complètes, en cours, ou non touchées.
    • Commencez par la première section autorisée non complète.
  3. Déterminer la structure de la page

    • Classez la page comme une question par page, toutes les questions sur une page, des champs de texte vides, un formulaire mixte, ou une iframe multi-origine.
    • Vérifiez si l'ordre des options change entre les tentatives.
    • Consultez references/browser-patterns.md pour des modèles d'interaction robustes.
  4. Remplir de manière conservatrice

    • Associez les réponses radio par le texte d'option normalisé exact lorsque c'est possible.
    • Utilisez des lettres ou des index seulement après avoir confirmé l'ordre actuel des options.
    • Préférez le remplissage groupé pour les pages stables où toutes les questions sont sur une seule page.
    • Pour les champs de texte réactifs, déclenchez des événements réalistes input et change.
    • Sur les workflows à une question par page, répondez, cliquez sur 下一题, attendez la navigation, puis ré-interrogez le DOM.
  5. Soumettre et vérifier chaque section

    • Soumettez seulement après avoir vérifié que le nombre de réponses correspond au nombre attendu.
    • Attendez un résultat, 继续学习, un score, un état de révision, ou un marqueur de complétion.
    • Après être passé à la section suivante, vérifiez que l'icône de répertoire de la section précédente est passée à « complète ».
    • Si un élément reste « en cours », inspectez ses pages enfants avant d'en supposer la cause.
  6. Gérer les tests et les iframes

    • Cliquez sur la confirmation d'entrée, démarrez le test, puis attendez que les ressources finissent de charger.
    • Confirmez et fermez toute superposition « ressources chargées » avant de remplir.
    • Utilisez des instantanés d'accessibilité et des outils de remplissage de formulaire pour le contenu des iframes multi-origines.
    • Soumettez, vérifiez le score/le nombre de réponses, puis utilisez le lien de retour ou de cours du système de test afin que le cours parent reçoive le résultat.
  7. Récupérer après une interruption

    • Ré-inspectez les icônes de complétion et l'état actuel des questions.
    • Rentrez uniquement dans les sections incomplètes.
    • Remplissez à nouveau une section lorsque la page affiche des réponses mais aucun marqueur de complétion.
    • Tenez un registre concis de la progression : terminé, ignoré sur instruction, en attente, et bloqué.
  8. Audit final

    • Relisez toutes les icônes de complétion cibles après une navigation ou un rafraîchissement.
    • Signalez les sections terminées, les types de questions ignorés, les scores, et toute raison de progression restante.

Efficacité

  • Utilisez un seul appel d'inspection pour collecter l'URL, les boutons visibles, les liens, le nombre de champs et les marqueurs de complétion.
  • Regroupez les lectures DOM indépendantes ; regroupez les écritures de formulaire stables.
  • Utilisez des liens directs de section ou des itinéraires connus seulement après avoir confirmé qu'ils appartiennent au cours actuel.
  • Attendez après une navigation et une soumission ; n'exécutez pas de longs scripts à travers les transitions de pages.
  • Préférez des opérations courtes et redémarrables plutôt qu'un script fragile couvrant plusieurs pages.

Standard de complétion

Appelez une section terminée seulement lorsqu'au moins un signal durable le confirme :

  • le marqueur de répertoire indique « terminé » ;
  • une page de résultat affiche le nombre attendu de réponses ou un score de passage ;
  • la page expose un état de soumission/révision et le cours l'enregistre.

Pour les sections contenant des tâches exclues (expression orale/enregistrement), signalez la portion non exclue comme soumise et expliquez pourquoi la section parente reste en cours.

Skills associés