Files
Support-Agent/run.md
T
2026-10-27 10:32:46 +01:00

84 lines
6.3 KiB
Markdown

# Pomper les données d'une station
Dans le terminal du dev container de l'appli (VS Code sur `~/monitoring-dashboard`, « Reopen in Container ») :
```bash
(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> --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 `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) : 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 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 :
```bash
python3 .claude/skills/boucle/comparaison.py data/<SERIE> vues-deplacements/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é) :
```bash
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) :
```bash
python3 .claude/skills/boucle/benchmark.py
```
Détails : `.claude/skills/boucle/SKILL.md`.
# Revoir les cas appris par la boucle
Dans une conversation Claude Code, sur `master` :
```
/revue-cas [C-xxx ...]
```
- Sans argument, tous les cas 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/revue-cas/C-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 cas validé ou rejeté est commité à part (D-075).
Détails : `.claude/skills/revue-cas/SKILL.md`.