Maintenance assistée

Répondre aux questions

Quand le besoin est ambigu, l'agent Analyse s'arrête et pose des questions plutôt que de deviner. L'exécution passe à l'état Précisions requises. Votre réponse crée une nouvelle tentative, qui reprend le travail avec cette précision.

Qui peut le faire : sur la plateforme, l'Opérateur, le Responsable et l'Administrateur. Sur GitHub, uniquement le responsable GitHub configuré pour le dépôt.

Voir les questions#

  1. Ouvrez l'exécution dont le badge indique Précisions requises.
  2. Dans l'onglet Agents et besoin, lisez la carte Questions du rôle Analyse.

Répondre depuis la plateforme#

  1. Dans la carte Actions sur l'exécution, rédigez votre texte dans le champ Votre réponse (4 000 caractères au plus ; les caractères accentués comptent un peu plus dans cette limite).
  2. Cliquez sur Envoyer la précision.
  3. Une nouvelle tentative Précision apparaît dans l'historique. L'en-tête de l'exécution d'origine propose Voir la tentative suivante.

Le formulaire n'apparaît que si l'exécution attend une réponse, n'est ni annulée ni archivée, et n'a pas déjà de tentative suivante.

Les étapes déjà validées sont réutilisées quand c'est possible : elles affichent Réutilisée et ne consomment aucun jeton.

Répondre sur GitHub avec /answer#

Si une PR brouillon existe déjà pour l'issue (brouillon précoce), les questions peuvent être publiées en commentaire sur cette PR. Le commentaire reprend les questions et rappelle la commande à utiliser.

Le responsable GitHub répond par un commentaire sur la PR :

text
/answer Le conteneur doit écouter sur le port 8080, pas 3000.

Pour être prise en compte, la réponse doit :

  • commencer par la commande /answer (nom par défaut ; l'exploitant peut le changer) ;
  • être postée par le responsable GitHub configuré, après le commentaire de questions ;
  • viser une PR toujours ouverte, dont la tête n'a pas été modifiée par un tiers.

Les autres commentaires, et ceux d'autres personnes, sont ignorés. La plateforme relève les réponses régulièrement : la nouvelle tentative apparaît après un court délai.

Suivre la publication des questions#

Dans l'onglet Suivi, la carte Notifications affiche la ligne Questions GitHub :

AffichageSignification
Commentaire publié (lien)Le commentaire existe sur la PR. Le lien y mène.
Publication à confirmerL'envoi est parti mais GitHub n'a pas confirmé. La plateforme cherche la preuve avant tout nouvel envoi.
autre étatVoir États et erreurs

La publication du commentaire exige, comme toute écriture sur GitHub, une notification préalable acceptée. Voir Notification avant publication (effet).

Ce qui se passe ensuite#

La tentative Précision reprend avec le même commit de base et le même besoin. Si l'issue ou la branche a changé entre-temps, elle s'arrête avec le motif « La base ou le besoin ne correspond plus à l'exécution précédente. ».

Pendant un arrêt global, votre réponse est acceptée et la tentative Précision attend la levée (mention En attente de la levée de l'arrêt global). Une réponse /answer est toujours relevée sur GitHub et crée aussi une tentative en attente.

Chaque réponse acceptée est datée et attribuée dans la chronologie du rapport d'incident. Le texte de votre réponse figure en annexe du rapport, pas dans le journal des actions.

Refus courants#

Message ou situationCauseQue faire
« Action de suivi indisponible. »Réponse vide ou trop longue, marqueur de secret, état changé, tentative déjà créée, ou plafond de reprises atteintRechargez la page et vérifiez l'historique
Aucune tentative après /answerAuteur différent du responsable GitHub, commande mal écrite, réponse antérieure au commentaire, PR fermée ou modifiéeVérifiez l'auteur et la commande, ou répondez depuis la plateforme
Formulaire absentRôle Lecteur, exécution annulée ou archivéeDemandez un rôle Opérateur

Une issue accepte au plus trois reprises, toutes origines confondues.

Pour continuer#

Relancer, annuler, archiver