Files
Support-Agent/run.md
T

4.8 KiB

Pomper les données d'une station

Dans le terminal du dev container de l'appli (VS Code sur ~/monitoring-dashboard, « Reopen in Container ») :

(set -a && . ./.env && set +a && python3 /workspaces/Support-Agent/extraction/pomper.py --du <DEBUT> --au <FIN> --images --delai 300 <SERIE>); chown -R 1000:1000 /workspaces/Support-Agent/data
  • <SERIE> : numéro de série du système, celui de l'URL de la page System (/explore/system/<SERIE>), par exemple NORDEND ; plusieurs stations : <SERIE1> <SERIE2>.
  • <DEBUT>, <FIN> : jours UTC, AAAA-MM-JJ, <FIN> exclu ; commencer 3 jours avant la période voulue (historique du journal). Le jour en cours n'est jamais pompé.
  • Sortie : data/<SERIE>/ (metrics/, displacement/, camera/, images/), hors de git (D-065) ; tous les outils et /aiguiser, /boucle y lisent.
  • Options : --diff ajoute les images différentielles dans images_diff/ (PNG 16 bits, ~7 Mo l'une contre ~1 Mo en JPG, ~160 Mo par jour ; ignorées par les outils de lecture) ; --every 10 une image toutes les 10 min (0 : toutes) ; sans --images, pas d'images.
  • Relancer la même commande ne récupère que ce qui manque (jour en échec, plage élargie, option ajoutée).

Détails : extraction/README.md.

Aiguiser la lecture de Claude

Dans une session Claude Code neuve, en mode auto (sinon elle s'arrête à chaque demande d'accord), à la racine de Support-Agent (pas dans le dev container), une fois les déplacements et les images pompés :

/aiguiser data/<SERIE> --du <DEBUT> --au <FIN>
  • <DEBUT>, <FIN> : jours UTC, AAAA-MM-JJ ; la plage s'arrête à <FIN> 00:00. Découpée en lots de 4 jours (--lot <jours> pour changer) ; 4 jours exactement = un seul lot, par exemple --du 2026-09-01 --au 2026-09-05.
  • Sans --du ni --au : toute la période du dossier.
  • Le modèle et l'effort choisis pour la session valent pour tous ses agents (D-063).
  • La séance tourne seule, sur une branche aiguiser/<séance>_<SERIE>, puis lance les commandes des fiches ; bilan dans vues-deplacements/aiguiser/<séance>_<SERIE>/bilan.md.

Détails : .claude/skills/aiguiser/SKILL.md.

Améliorer les détecteurs du journal (boucle)

Dans une session Claude Code neuve, en mode auto, à la racine de Support-Agent (pas dans le dev container), une fois les déplacements et les images pompés :

/boucle data/<SERIE> --du <DEBUT> --au <FIN> --ameliorer
  • --ameliorer (facultatif) : en fin de séance, l'améliorateur corrige le processus d'après les difficultés relevées ; l'enlever pour une séance sans correction.
  • <DEBUT>, <FIN> : jours UTC, AAAA-MM-JJ, <FIN> exclu (la plage s'arrête à <FIN> 00:00). La plage est le lot, sans découpe : sa longueur se choisit par les dates (4 jours : --du 2026-09-01 --au 2026-09-05), D-072.
  • Sans --du ni --au : toute la période du dossier, en un lot. Le lot est classé avec ses 3 jours d'avant : les pomper aussi.
  • Le modèle et l'effort choisis pour la session valent pour tous ses agents (D-063).
  • La séance tourne seule, sans question, à lancer sur master, où elle commite directement (D-070), un commit par étape : analyste, upgrader et validateur si l'analyste a des suggestions, builder s'il y a des nouveautés, puis le releveur, qui note les difficultés dans docs/ameliorations-processus.md (rien à demander). Avec --ameliorer, l'améliorateur corrige ensuite le skill /boucle et ses agents d'après ces relevés et marque les entrées traité ; ce qui sort de son périmètre (outils de lecture, détecteurs) ou change ce que fait la boucle reste à traiter à la main (D-071). Les fichiers modifiés et non commités restent sans être commités.
  • Bilan dans vues-deplacements/boucle/<séance>_<SERIE>/bilan.md ; les étiquettes de l'analyste (lot-*/etiquettes.json) sont à garder même si on annule une modification. Ensuite : git revert des commits de la séance qu'on ne garde pas (la base de la séance est dans le bilan).
  • À la fin, la page out/boucle_<séance>_<SERIE>.html s'ouvre (D-066) : les courbes de la plage ; dessous, catégorie par catégorie, l'analyste (bleu) face aux détecteurs (orange) ; le score de la séance et le benchmark.
  • Le benchmark (D-069) : les détecteurs face au diagnostic gardé dans chaque cas de la base (agents/diagnostic/cas/C-*/etiquettes.json), lancé au début de chaque lot, après chaque modification et en fin de séance ; chaque passage s'ajoute à vues-deplacements/benchmark/historique.csv, avec la version des détecteurs.

Refaire la page d'une séance :

python3 .claude/skills/boucle/comparaison.py data/<SERIE> vues-deplacements/boucle/<séance>_<SERIE>

Lancer le benchmark à la main (sans rien écrire dans l'historique) :

python3 .claude/skills/boucle/benchmark.py

Détails : .claude/skills/boucle/SKILL.md.