Files
Support-Agent/run.md
T
maximeandClaude Opus 5.5 21f8cd1db6 Loop: upgrader and validator become detectors-upgrader and detectors-control (D-089)
- detectors-upgrader: makes the detectors better on the batch from the
  analyst's critique; adds, removes or modifies, removing first; targets
  the significant events missed or badly bounded, not a perfect match.
- detectors-control: the guard against overfitting; never looks at the
  batch, judges the diff and the benchmark on the event base, decides,
  and sends its remarks back to the upgrader.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-29 08:45:57 +01:00

8.4 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.

Compléter les métriques de qualité d'une caméra (optical_emulator)

Les anciennes caméras n'ont pas les six métriques de qualité (peak, flux, sharpness, fwhm, dominance, snr) dans leurs déplacements. ~/optical_emulator les recalcule à partir des images DIFF, en rejouant sur CPU le calcul du GPU des caméras récentes.

  1. Dans le terminal du dev container de l'appli, pomper les images DIFF (une par mesure de 15 min), puis extraire les fenêtres des capteurs et les propriétés des images DIFF (lecture seule) :
(set -a && . ./.env && set +a && python3 /workspaces/Support-Agent/extraction/pomper.py --du <DEBUT> --au <FIN> --diff --every 15 <SERIE>); chown -R 1000:1000 /workspaces/Support-Agent/data
(set -a && . ./.env && set +a && python3 /workspaces/optical_emulator/extraction/capteurs.py <SERIE> --du <DEBUT> --au <FIN>); chown -R 1000:1000 /workspaces/Support-Agent/data
  1. Dans WSL (pas dans le container), à la racine de ~/optical_emulator, calculer :
.venv/bin/python -m emulateur.calculer <SERIE> --du <DEBUT> --au <FIN>
  • Sortie : data/<SERIE>/quality/<SERIE>_quality_<AAAAMMJJ>.csv, une ligne par image DIFF et par capteur actif, avec :

    • les six métriques, en unités de l'image DIFF ;
    • stacking, exposition, gain de l'image ;
    • rotation, la rotation appliquée à l'image ;
    • flag : vide (pas de cible nette) ou bord (cible décentrée).

    Jointure avec displacement/ sur time_utc et sensor_name.

  • La rotation de l'image est détectée (NADELHORN : 180°) ; si elle est ambiguë, la commande s'arrête : --rotation 0|90|180|270.

  • Les capteurs archivés sont ignorés, sauf avec --archives. Un jour déjà écrit est sauté, sauf avec --force.

  • Vérifier l'émulateur sur une caméra récente (métriques déjà dans displacement/, NADELHORN par défaut) : .venv/bin/python -m emulateur.valider [<SERIE>], qui écrit out/validation_<SERIE>.md.

  • Dans Claude Code, à la racine de ~/optical_emulator : /calculer <SERIE> [<DEBUT>] [<FIN>] et /valider [<SERIE>].

Détails : ~/optical_emulator/CLAUDE.md et ~/optical_emulator/emulateur/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> --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 (D-076).
  • <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-078.
  • 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, à lancer sur master, où elle commite directement (D-077), puis lance les commandes des fiches ; bilan dans 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, detectors-upgrader et detectors-control 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 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) : la page de detecteurs.py (ci-dessous) sur la plage, images et timelapse compris ; dessous les courbes, 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 event de la base (events/E-*/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> boucle/<séance>_<SERIE>

Voir les détecteurs seuls sur une station et une plage, sans boucle ni analyste (rien n'est modifié ni commité) :

python3 .claude/skills/boucle/detecteurs.py data/<SERIE> --du <DEBUT> --au <FIN>
  • <FIN> exclu ; sans dates, toute la période du dossier. La plage est classée avec ses 3 jours d'avant, comme un lot.
  • Page out/detecteurs_<SERIE>_<DEBUT>_<FIN>.html, ouverte seule : corr_x et corr_y de tous les capteurs, une ligne par catégorie (survol : capteurs et phrase), puis la liste des événements.

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

python3 .claude/skills/boucle/benchmark.py

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

Revoir les events appris par la boucle

Dans une conversation Claude Code, sur master :

/review-event [E-xxx ...]
  • Sans argument, tous les events dont la fiche dit non revalidé par l'expert. L'agent revue présente chacun (station et capteurs sous leurs vrais noms, séance d'origine, diagnostic proposé, figures, points à trancher) dans une page web, out/review-event/E-xxx.html, ouverte seule : sa présentation, la page des détecteurs sur la plage, la fiche, la critique du lot d'origine et toutes les figures ; on répond dans la conversation : valider, corriger (en clair), rejeter ou passer. Chaque event validé ou rejeté est commité à part (D-075).

Détails : .claude/skills/review-event/SKILL.md.