Files
Support-Agent/docs/ameliorations-processus.md
T
2026-10-26 13:30:34 +01:00

13 KiB

Améliorer les processus automatiques

Carnet des difficultés rencontrées par les processus automatiques du projet (aujourd'hui /boucle), tenu par l'agent releveur (D-060). Chaque sous-agent finit son rendu par une section ## Difficultés ; en fin de processus, l'orchestrateur les transmet au releveur, qui les note ici. Les corrections se font ensuite, dans une conversation à part, à partir de ce carnet.

Comment noter une difficulté

Une entrée par cause, sous la rubrique du processus :

  • Titre court (AAAA-MM-JJ, consigne floue | contradiction | consigne absente | chemin | format | commande | autre) : ce qui s'est passé, en une ou deux phrases. En cause : fichier:ligne (la consigne, le fichier ou la commande). Occurrences : séance, lot, agent ; une par ligne ou séparées par « ; ». Piste (facultative) : une phrase.

Une même cause revue ajoute une occurrence, pas une entrée. Quand le processus est corrigé, l'entrée prend la mention traité.

/boucle

  • Nom de la branche de séance (2026-10-24, contradiction) : le skill nomme la branche avec l'heure (boucle/<SEANCE>_<STATION>, SEANCE = date -u +%Y-%m-%dT%H%MZ), la spec avec le jour seul (boucle/<AAAA-MM-JJ>_<STATION>), alors qu'elle donne l'heure au dossier de la séance ; l'orchestrateur a suivi le skill. En cause : .claude/skills/boucle/SKILL.md:16-17 et :57 contre vues-deplacements/contexte/boucle-automatique.md:44 et :115 (le plan docs/superpowers/plans/2026-10-24-boucle-automatique.md:195 et vues-deplacements/CLAUDE.md:23 suivent le skill). Occurrences : essai du releveur, sans séance, orchestrateur. Piste : aligner la spec sur le skill (avec le jour seul, deux séances le même jour sur la même station tomberaient sur la même branche).

/aiguiser

Séance de référence des entrées ci-dessous : 2026-10-26T1149Z, NORDEND, lot 01 et contrôle (S1 dans les occurrences). Les faits vérifiés dans le dépôt sont donnés comme tels ; ce qui ne vient que du dire d'un agent est marqué « selon l'agent ».

  • Commandes Bash hors de la liste du skill (2026-10-26, contradiction) : le skill de lecture ne permet que les outils, ls, grep et date, un tube vers grep seulement. Les lecteurs ont pourtant eu besoin de head, tail, sed, cut, wc, de grep sur un fichier de résultats et de mkdir -p : sortie trop longue à lire, chemin du PNG à isoler. Ils l'ont fait sans savoir si c'était permis (une commande grep | cut | sed n'a rendu aucune sortie). Le mkdir -p paraît inutile : ensemble.py, graphique.py et vignettes.py créent leur dossier de sortie (ensemble.py:87, graphique.py:83, vignettes.py:60) ; C-002 dit pourtant en avoir eu besoin, non vérifié. En cause : .claude/skills/lire-les-donnees/SKILL.md:33 (liste de commandes), .claude/agents/lecteur.md:25. Occurrences : S1 lot 01 lecture-1 (grep -v sur fichier), lecture-2 (tail, head), lecture-3 (wc -l, head, tail), lecture-4 (sed, grep sur fichier) ; S1 contrôle C-002 (sed, mkdir -p), C-004 (mkdir -p, head), C-005 (cut, sed). Piste : voir l'entrée suivante, qui en est la cause première.

  • Sortie d'inventaire.py trop longue pour s'afficher (2026-10-26, commande) : sur ce dépôt, l'inventaire rend 72 à 73 Ko (selon les agents : 841 lignes « autres fichiers », 29 exports, 696 images, 923 lignes avec --debut/--fin) ; Bash la range dans un fichier de résultats que le lecteur doit relire par grep, sed ou head, d'où l'entrée précédente. Le skill n'annonce pas cette longueur. Non revérifié (taille donnée par les agents). En cause : .claude/skills/lire-les-donnees/SKILL.md:21 (ligne de l'outil), :38 (méthode : « Inventaire »). Occurrences : S1 lot 01 lecture-1, lecture-2, lecture-3, lecture-4. Piste : que l'outil n'imprime pas la liste des fichiers hors déplacements.

  • inventaire.py refusait --debut et --fin au départ de la séance (2026-10-26, contradiction) : la demande du lecteur dit d'appeler « les outils avec --debut et --fin du lot », mais la ligne du skill pour inventaire.py n'en citait pas (vérifié : git show 4424ea1^) et l'outil ne les acceptait pas ; il imprimait son usage. La modification 2 de la séance les a ajoutés (agents/diagnostic/outils/inventaire.py:119-120, commit 53eaf45) : le défaut est donc corrigé dans la branche de séance, à garder ou non par l'utilisateur. En cause : .claude/agents/lecteur.md:25 contre .claude/skills/lire-les-donnees/SKILL.md:21 (avant la séance). Occurrences : S1 lot 01 lecture-1.

  • « Toute la période » au contrôle : quelle fenêtre ? (2026-10-26, consigne floue) : le skill dit de passer --debut/--fin du lot, et que la section sur la fenêtre de inventaire.py n'existe qu'avec elles ; au contrôle, la demande est « Toute la période » sans bornes. Les lecteurs ont lancé sans bornes (pas de section de fenêtre), puis ont choisi eux-mêmes des bornes pour zoomer. En cause : .claude/skills/aiguiser/SKILL.md:51, .claude/agents/lecteur.md:25 (« sans eux pour toute la période »), .claude/skills/lire-les-donnees/SKILL.md:32 et :38. Occurrences : S1 contrôle C-001 lecture, C-002 lecture.

  • Fin d'un lot : incluse ou non ? (2026-10-26, consigne floue) : le lot est écrit <début> → <fin> (ici 09-01T00:00Z → 09-04T00:00Z) et le skill de lecture dit que --fin inclut la minute indiquée, donc le point du 04/09 00:00 est dans la lecture ; le correcteur, lui, écrit des fins de moment « 09-04 00:00 » alors que « le lot s'arrête avant ». Chacun a tranché de son côté. En cause : .claude/skills/aiguiser/SKILL.md:22 et :28 contre .claude/skills/lire-les-donnees/SKILL.md:32. Occurrences : S1 lot 01 lecture-2, ecart-4.

  • Méthode du skill : rien n'indique ce qui est facultatif (2026-10-26, consigne floue) : la méthode enchaîne inventaire, ensemble, graphique.py sur tous les capteurs (error_value, corr_x, corr_y), resume.py à 6h/1d, zoom, vignettes « une toutes les 2 à 3 h » ; les lecteurs ont sauté des étapes sans savoir si c'était attendu (C-001 : pas de graphique.py sur tous les capteurs ni de resume.py 6h/1d) ou fait peu de planches (lecture-1 : 4 planches de 4 capteurs, jugeant la cadence incompatible avec les permissions par commande). En cause : .claude/skills/lire-les-donnees/SKILL.md:39 et :42. Occurrences : S1 lot 01 lecture-1 ; S1 contrôle C-001 lecture.

  • Unité de l'ampleur : MAD ou bruits (2026-10-26, consigne floue) : le skill demande l'ampleur « en MAD ou en fois la médiane », alors que ensemble.py rend ses écarts en « bruits » (médiane des écarts entre deux mesures, lire-les-donnees/SKILL.md:24) ; le lecteur a reporté les deux sans convertir. En cause : .claude/skills/lire-les-donnees/SKILL.md:52 contre :24. Occurrences : S1 contrôle C-001 lecture.

  • corr ou relative : lequel privilégier (2026-10-26, consigne floue) : la méthode dit corr_x, corr_y « ou relative_x, relative_y » sans critère de choix ; le lecteur a pris corr seul. Sans gêne pour le lot. En cause : .claude/skills/lire-les-donnees/SKILL.md:39. Occurrences : S1 lot 01 lecture-1.

  • Tables d'ensemble.py : étiquettes décalées d'une heure (2026-10-26, commande) : les pas partent de la première mesure de la fenêtre (t0), pas d'une heure pleine ; une mesure horodatée hh:00:00,x tombe dans le pas précédent. Sur la période entière du cas C-005 (première mesure 22:00:13), la table saute 00:00, 12:00 et 11:00 alors que les absents sont 01:00, 13:00 et 12:00 (selon l'agent ; le calcul t0 + ((t - t0) // pas) * pas est vérifié en agents/diagnostic/outils/ensemble.py:144, :164, :200). Le lecteur a relancé sur des fenêtres commençant à l'heure pleine et gardé « à ±1 h ». La même cause est possible pour les lignes qui manquent dans la table à 15 min du lecteur du lot 01 (selon l'agent, non vérifié). En cause : agents/diagnostic/outils/ensemble.py:144. Occurrences : S1 contrôle C-005 lecture ; S1 lot 01 lecture-3 (possible).

  • Scripts du correcteur : bibliothèque standard imposée, mais les images exigent Pillow et numpy (2026-10-26, contradiction) : la consigne demande des scripts en bibliothèque standard, .venv/bin/python seulement avec matplotlib pour les figures ; les recadrages et pics par capteur sur les images demandent Pillow et numpy, que le correcteur a utilisés via .venv/bin/python, sans savoir si c'était permis. En cause : .claude/agents/correcteur.md:27. Occurrences : S1 lot 01 ecart-1.

  • Fichiers du correcteur écrits hors de <lot>/corrige/ (2026-10-26, consigne floue) : f_images.png et img1.json sont restés à la racine du dépôt, non suivis (vérifié : git status, créés le 2026-10-26 à 12:56 UTC), et les scripts fig1.py, fig2.py, fig3.py y ont d'abord été écrits avant d'être déplacés dans corrige/. La consigne dit où mettre les scripts et les figures, pas où vont les sorties des scripts quand ils sont lancés depuis la racine. En cause : .claude/agents/correcteur.md:27 (« scripts et figures dans <lot>/corrige/ … lance-les depuis la racine du dépôt »). Occurrences : S1 lot 01 ecart-1 (scripts), ecart-2, ecart-3, ecart-4 (les deux fichiers) ; orchestrateur.

  • vues-deplacements/CLAUDE.md et l'état git injectés malgré omitClaudeMd: true (2026-10-26, autre) : presque tous les agents disent avoir reçu, en cours de travail, le contenu de vues-deplacements/CLAUDE.md (parfois aussi le gitStatus avec les titres des derniers commits « lecture 2 », « écart 2 »), alors que leurs consignes cherchent à l'écarter pour ne pas fausser la mesure. Les consignes prévoient de le signaler dans « Sources lues » ; ils l'ont en plus mis en « Difficultés ». Cause supposée (non vérifiée) : le contexte d'un sous-dossier se charge dès qu'un fichier de ce dossier est lu, ce que omitClaudeMd ne couvre pas. En cause : .claude/agents/lecteur.md:6 et :21, .claude/agents/correcteur.md:6 et :23. Occurrences : S1 lot 01 lecture-1, lecture-2, lecture-3, lecture-4, ecart-1, ecart-2, ecart-3, ecart-4 ; S1 contrôle C-002 lecture et ecart, C-003 lecture et ecart, C-005 lecture et ecart.

  • Au contrôle, la faute « outil » ou « mode d'emploi » se juge sans lire le skill (2026-10-26, contradiction) : le correcteur doit classer chaque manque en faute d'outil, de mode d'emploi ou de lecteur, mais il lui est interdit de lire le skill et d'utiliser les outils ; il infère donc la faute du texte de la lecture et de son « Ce qui m'a manqué ». En cause : .claude/agents/correcteur.md:23 contre :47-49. Occurrences : S1 contrôle C-002 ecart (D1, D2), C-003 ecart (critère 2), C-004 ecart.

  • Contrôle : un critère à moitié retrouvé n'a pas de verdict, et le décompte ment (2026-10-26, consigne floue) : le verdict d'un cas est « manqué » dès qu'un critère manque, donc le bilan compte « 0 retrouvé sur 5 » même quand C-001 a 4 critères sur 5 retrouvés, et la formule (<n> retrouvés sur <m>) du message de commit ne dit pas si elle compte les cas ou les critères ; le correcteur de C-005, lui, n'avait pas de mot pour un critère à moitié retrouvé et a écrit « retrouvé en partie ». En cause : .claude/skills/aiguiser/SKILL.md:60 (message de commit), .claude/agents/correcteur.md:84 (« manqué » dès qu'un critère est manqué), :57. Occurrences : S1 contrôle C-005 ecart ; orchestrateur (commit contrôle (0 retrouvés sur 5), bilan).

  • Au contrôle, la demande du correcteur ne donne pas le dossier des données (2026-10-26, consigne floue) : la demande cite la fiche et la lecture, dont le dossier est out/aiguiser/<SEANCE>/C-xxx/ (liens) ; le correcteur a trouvé les données dans agents/diagnostic/cas/C-005/displacement/ et lu cette copie, la consigne ne disant pas laquelle. En cause : .claude/skills/aiguiser/SKILL.md:50-52, .claude/agents/correcteur.md:15 et :21. Occurrences : S1 contrôle C-005 ecart.

  • Arguments mal formés : que faire sans pouvoir poser de question ? (2026-10-26, consigne absente) : la commande est arrivée avec <SERIE> tel quel et des dates 2026-09.01 / 2026-09.04 ; le skill interdit toute question à l'utilisateur et n'indique la conduite à tenir (« dis-le et arrête-toi ») que pour l'absence d'export « advanced ». L'orchestrateur a deviné NORDEND (seul dossier de out/pompage/, vérifié) et 2026-09-01 → 2026-09-04, et l'a écrit dans le bilan. En cause : .claude/skills/aiguiser/SKILL.md:10 (« aucune question »), :14 (arguments), :15, :5 (argument-hint). Occurrences : S1, orchestrateur.

  • Contrôle : parallélisme non précisé (2026-10-26, consigne floue) : le skill décrit le contrôle cas par cas (lecteur puis correcteur, pour chaque C-xxx) sans dire si les cinq cas peuvent tourner en parallèle ; l'orchestrateur l'a fait. En cause : .claude/skills/aiguiser/SKILL.md:46-52. Occurrences : S1, orchestrateur.