- inventaire.py: what each source contains on the window (filled or empty columns, metric names, images), names and counts only - analyser-lot: step 0 on the data, own scripts in <lot>/outils/, section 3 "Outils" - tool-builder (the optimiser, rewritten): after the analyst, optimises or adds reading tools, never removes; no control yet - /aiguiser skill, reader, corrector and voir.py removed; its sessions and spec stay as history - docs: D-097, specs, CLAUDE.md, run.md, README, plan point 56; the shared files also carry another session's pending edits (D-096 entry, plan points 57 to 67) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
105 lines
15 KiB
Markdown
105 lines
15 KiB
Markdown
---
|
|
name: events-learner
|
|
description: Séance automatique d'amélioration des détecteurs du journal du matin et de la base d'events, sur un lot d'une station, la plage choisie par l'utilisateur (D-057) — analyste, tool-builder, detectors-critic, detectors-upgrader, detectors-control, event-builder. Lancé par l'utilisateur seulement, avec /events-learner.
|
|
disable-model-invocation: true
|
|
argument-hint: "data/<STATION> [--du AAAA-MM-JJ] [--au AAAA-MM-JJ] [--ameliorer]"
|
|
---
|
|
|
|
# events-learner : la boucle automatique
|
|
|
|
Tu es l'orchestrateur. Tu appelles les six agents dans l'ordre, tu transmets leurs rendus et tu commites ; en fin de séance, le releveur note leurs difficultés. **Tu ne juges rien toi-même** : tu lis seulement les lignes de verdict. **Tu ne poses aucune question à l'utilisateur** : la séance tourne seule jusqu'au bout. Spec : `vues-deplacements/contexte/events-learner.md`.
|
|
|
|
## 1. Mise en place
|
|
|
|
- Arguments : le dossier de station ; un nom de station seul (« Nordend ») désigne `data/<NOM EN MAJUSCULES>/` (D-065) ; `--du`, `--au` (jours UTC, facultatifs : sans eux, toute la période ; **`--au` est exclu** : la plage s'arrête à `--au` 00:00Z, `--du 2026-09-01 --au 2026-09-05` fait 4 jours) ; `--ameliorer` (facultatif : en fin de séance, l'améliorateur corrige le processus d'après les relevés du releveur, §6, D-071). **La plage est le lot** (D-072) : une séance traite un seul lot, de la longueur que l'utilisateur a choisie par `--du` / `--au`, sans découpe ; un `--lot` ou `--tranche` donné quand même est ignoré (note-le sous « Erreurs »). Des dates écrites autrement (« 2026-09.01 », deux dates sans option) se lisent comme `--du` puis `--au` ; une option entre crochets (`[--ameliorer]`, la syntaxe d'usage recopiée) vaut l'option sans crochets ; écris dans le bilan, sous « Erreurs », comment tu as lu un argument qui n'était pas net.
|
|
- `python3 agent-tools/inventaire.py <dossier>` : dossier absent ou sans export « advanced », dis-le et arrête-toi.
|
|
- `STATION` = le nom du dossier de station (`NORDEND`) ; `SEANCE` = `date -u +%Y-%m-%dT%H%MZ`.
|
|
- La séance se commite directement sur `master` (D-070) : `git branch --show-current` doit dire `master`, sinon dis-le et arrête-toi (pas de `git switch` : une autre session peut travailler dans ce dépôt). Note la **base de la séance** : `git rev-parse HEAD`. Les fichiers modifiés de l'utilisateur restent sans être commités : tu commites toujours par chemin. Une autre session peut travailler dans le même dépôt pendant la séance (fichiers modifiés, index déjà chargé, même ce skill) : `git commit -- <chemins>` ne prend que tes chemins ; n'indexe rien d'autre, jamais de `git add -A`, `git stash` ni `git checkout` hors de tes chemins ; garde les consignes lues au début et note le changement dans tes difficultés. Le commit par chemin ne protège pas un fichier que tu commites toi-même : note donc, au début, les fichiers déjà modifiés sur les chemins que la séance commite ou fait tourner, `git status --porcelain -- detectors/ vues-deplacements/contexte/seuils-du-journal.md agent-diagnostic/ .claude/skills/anonymize-event/registre.csv agent-tools/ .claude/skills/lire-les-donnees/` ; s'il y en a, liste-les au bilan sous « Erreurs » (les mesures tournent sur eux), ne les commite pas et ne les annule pas : aux étapes 2, 4 et 5 (outils, `annuler`), donne tes chemins fichier par fichier, sans eux (`git diff --name-only <base du lot> HEAD -- <chemins>` liste ceux de la séance).
|
|
- Dossier de séance : `events-learner/<SEANCE>_<STATION>/`, ci-dessous `<séance>`.
|
|
|
|
## 2. Le lot
|
|
|
|
Un seul lot, numéroté `01` (`NN` ci-dessous) : de `--du` 00:00Z (sinon le premier jour de la « Période des mesures » de l'inventaire, 00:00Z) à `--au` 00:00Z (sinon la fin de cette période). Une date qui déborde cette période y est ramenée (`--du` au premier jour de la période, `--au` au lendemain de son dernier jour), dans les bornes du lot comme dans sa commande, et dite sous « Erreurs » du bilan : hors de la période, il n'y a rien à lire ni à étiqueter. Dossier du lot : `<séance>/lot-01/`, ci-dessous `<lot>`.
|
|
|
|
**Commande du lot**, donnée telle quelle aux agents : `python3 detectors/categories.py <dossier>`, plus `--du` et `--au` s'ils sont donnés. Exemple : `--du 2026-10-05 --au 2026-10-09`.
|
|
|
|
## 3. Le lot, dans l'ordre
|
|
|
|
Chaque agent est appelé par l'outil Agent avec son `subagent_type` et la demande ci-dessous, rien d'autre. Un verdict se lit par `grep '^\*\*Verdict\*\* :' <rendu>`. Chaque commit se fait par chemin, `git add <chemins> && git commit -m "<message>" -- <chemins>`, après `git branch --show-current` : une autre session peut changer de branche pendant la séance ; si ce n'est plus `master`, ne commite plus rien (pas de `git switch`), passe au bilan, écrit sans commit, et note la branche trouvée sous « Erreurs ». Son message se termine par une ligne vide puis `Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>`.
|
|
|
|
1. **Analyste** (`analyste`) : `Dossier : <dossier>. Lot NN : <début> → <fin> (UTC). Commande du lot : <commande>. Écris <lot>/analyse.md.`
|
|
`python3 .claude/skills/analyser-lot/etiquettes.py <dossier> <lot>/etiquettes.json` : sa dernière ligne va au bilan (colonne Étiquettes : « n moments », « absentes » ou « n défauts ») ; tu ne corriges rien et ne relances pas l'analyste pour elles (D-061).
|
|
Commit `<lot>/`, message `Learn <STATION> lot NN: analysis`.
|
|
2. **Tool-builder** (`tool-builder`), à chaque lot : il lit la section « Outils » de l'analyse et améliore les outils de lecture, sans en retirer (D-097) : `Dossier : <dossier>. Lot NN : <début> → <fin> (UTC). Analyse : <lot>/analyse.md. Écris <lot>/tool-builder.md.`
|
|
Sa ligne `grep '^\*\*Outils modifiés\*\* :' <lot>/tool-builder.md` va au bilan (colonne Outils). Commit de `<lot>/` et des chemins que `git status --porcelain -- agent-tools/ .claude/skills/lire-les-donnees/` montre, sans les fichiers notés au début (§1), message `Learn <STATION> lot NN: tools (<ligne Outils modifiés>)`. Score et benchmark se calculent après lui : les détecteurs lisent par `agent-tools/donnees.py`, et toutes les mesures de la séance portent ainsi sur la même lecture.
|
|
`python3 .claude/skills/events-learner/score.py <dossier> > <lot>/score-avant.txt 2>&1` : le score des détecteurs du début du lot sur toutes les étiquettes de la station, ce lot compris (D-062).
|
|
`python3 .claude/skills/events-learner/benchmark.py --seance <SEANCE> --etape "lot-NN avant" > <lot>/benchmark-avant.txt 2>&1` : le benchmark, les détecteurs face au diagnostic gardé dans chaque event de la base, ajouté à l'historique (D-069).
|
|
Commit `<lot>/ vues-deplacements/benchmark/historique.csv`, message `Learn <STATION> lot NN: score and benchmark`.
|
|
3. **Detectors-critic** (`detectors-critic`), qui juge les détecteurs face à l'analyse, sans regarder les données (D-090) : `Dossier : <dossier>. Lot NN : <début> → <fin> (UTC). Commande du lot : <commande>. Analyse : <lot>/analyse.md. Score avant : <lot>/score-avant.txt. Écris <lot>/critique.md.`
|
|
Commit `<lot>/`, message `Learn <STATION> lot NN: critique (<verdict>)`.
|
|
Verdict `d'accord` : va à l'étape 6.
|
|
4. **Detectors-upgrader** (`detectors-upgrader`), passage K = 1, 2 ou 3. Avant le passage 1, note la **base du lot** : `git rev-parse HEAD`.
|
|
`Dossier : <dossier>. Lot NN : <début> → <fin> (UTC). Commande du lot : <commande>. Critique : <lot>/critique.md. Score avant : <lot>/score-avant.txt. Benchmark avant : <lot>/benchmark-avant.txt. [Contrôle précédent : <lot>/validation-(K-1).md.] Passage K. Écris <lot>/modification-K.md.`
|
|
Commit `detectors/ vues-deplacements/contexte/seuils-du-journal.md <lot>/`, message `Learn <STATION> lot NN: modification K`.
|
|
Puis, les détecteurs commités : `python3 .claude/skills/events-learner/benchmark.py --seance <SEANCE> --etape "lot-NN modification K" > <lot>/benchmark-K.txt 2>&1` (commité avec la validation).
|
|
5. **Detectors-control** (`detectors-control`), le garde-fou : il ne regarde pas le lot (ni dossier, ni critique, ni score : D-089), seulement la modification et la base d'events : `Lot NN. Modification : <lot>/modification-K.md. Benchmark : <lot>/benchmark-avant.txt → <lot>/benchmark-K.txt. Base : <base du lot>. Passage K sur 3. Écris <lot>/validation-K.md.`
|
|
Commit `<lot>/ vues-deplacements/benchmark/historique.csv`, message `Learn <STATION> lot NN: control K (<verdict>)`.
|
|
- `accepté` ou `garder` : va à l'étape 6.
|
|
- `à reprendre` : retour à l'étape 4, passage K + 1.
|
|
- `annuler` : `git checkout <base du lot> -- detectors/ vues-deplacements/contexte/seuils-du-journal.md`, commit de ces deux chemins, message `Learn <STATION> lot NN: modification annulée`.
|
|
6. **Event-builder** (`event-builder`), à chaque lot : il décide seul, face à la base d'events, ce que l'analyse lui apprend de nouveau (D-091) : `Dossier : <dossier>. Lot NN : <début> → <fin> (UTC). Analyse : <lot>/analyse.md. Dossier du lot : <lot>/. Séance : <séance>/. Écris <lot>/builder.md.`
|
|
Si sa ligne `**Events créés** :` n'est pas `aucun` : commit `events/ .claude/skills/anonymize-event/registre.csv <lot>/`, message `Learn <STATION> lot NN: events E-xxx, …` ; sinon commit `<lot>/`, message `Learn <STATION> lot NN: event-builder (aucun event)`.
|
|
|
|
L'analyste ne relit pas les lots des séances d'avant ; le score les rejoue, sur leurs étiquettes, et le benchmark rejoue les events de la base, les events créés au lot compris (leur `etiquettes.json`).
|
|
|
|
## 4. Imprévus
|
|
|
|
Un rendu absent après son agent, ou sans ligne de verdict lisible : note-le pour le bilan ; si les détecteurs ont changé depuis la base du lot, remets-les comme pour `annuler` ; passe au bilan. Seule exception, le tool-builder : sans rendu ou sans ligne « Outils modifiés », remets les outils tels qu'avant lui, fichier par fichier, sans les fichiers notés au début (`git checkout HEAD -- <fichier>` pour ceux que `git diff --name-only HEAD -- agent-tools/ .claude/skills/lire-les-donnees/` liste), commite `<lot>/` et continue au score et au benchmark. Ne relance pas un agent plus d'une fois.
|
|
|
|
## 5. Bilan
|
|
|
|
`python3 .claude/skills/events-learner/score.py <dossier> > <séance>/score-fin.txt 2>&1` : le score des détecteurs de fin de séance sur toutes les étiquettes de la station.
|
|
Pas de benchmark de fin de séance : celui des détecteurs de fin est le dernier du lot, sur les mêmes events que celui du début ; les events créés par l'event-builder se mesurent à la séance suivante (D-092).
|
|
|
|
`<séance>/bilan.md` :
|
|
|
|
```markdown
|
|
# Séance <SEANCE> : <STATION>, <début> → <fin> (UTC)
|
|
|
|
Commits : sur `master`, depuis <base de la séance> (`git log --oneline <base de la séance>..HEAD`)
|
|
|
|
Score : au début du lot `lot-01/score-avant.txt`, en fin de séance `score-fin.txt` (D-062).
|
|
|
|
Benchmark sur la base d'events (D-069) : au début du lot `lot-01/benchmark-avant.txt`, après chaque modification `lot-01/benchmark-K.txt` ; historique `vues-deplacements/benchmark/historique.csv`. Total, sur les mêmes events : <ligne `total` de la catégorie `toutes` de `benchmark-avant.txt`, colonnes alignées : `grep -E '^total +toutes'`> → <celle du benchmark de la modification gardée (`benchmark-K.txt`), ou « inchangé » si aucune n'est gardée>.
|
|
|
|
Page : `out/events-learner_<SEANCE>_<STATION>.html`, l'analyste face aux détecteurs sur toute la plage (D-066) ; la refaire : `python3 .claude/skills/events-learner/comparaison.py <dossier> <séance>`.
|
|
|
|
| Lot | Dates (UTC) | Outils | Critique | Étiquettes | Modification | Events créés |
|
|
|---|---|---|---|---|---|---|
|
|
| 01 | … → … | aucun / fichiers modifiés (`donnees.py` dit à part) / erreur | d'accord / suggestions (n) | n moments / absentes / n défauts | aucune / gardée (K passages) / annulée / erreur | E-xxx / aucun |
|
|
|
|
## Suggestions non traitées
|
|
<« Pas corrigé » des modifications ; suggestions d'un lot sans modification gardée>
|
|
|
|
## Contradictions avec la base
|
|
<lignes « contredit » du rendu de l'event-builder>
|
|
|
|
## Erreurs
|
|
aucune | <lot, agent, ce qui manquait>
|
|
```
|
|
|
|
Commit `<séance>/bilan.md <séance>/score-fin.txt`, message `Learn <STATION>: bilan`.
|
|
|
|
## 6. Difficultés
|
|
|
|
**Releveur** (`releveur`), une fois, même si tout s'est bien passé : `Processus : /events-learner (.claude/skills/events-learner/SKILL.md). Séance : <séance>/ : la section « Difficultés » de chaque rendu des lots, et « Erreurs » du bilan. Difficultés de l'orchestrateur : aucune | <une consigne de ce skill qui t'a fait deviner, une commande qui a échoué…>.` (D-060)
|
|
Si `git status --short docs/ameliorations-processus.md` montre un changement : commit de ce chemin, message `Learn <STATION>: process difficulties`.
|
|
|
|
**Améliorateur** (`ameliorateur`), seulement avec `--ameliorer` et si le releveur a commité : `Processus : /events-learner. Commit du releveur : <commit>.`, le commit pris par `git rev-parse HEAD` juste après celui du releveur (D-071). Puis commit des chemins qu'il a pu toucher, `.claude/skills/events-learner/ .claude/skills/analyser-lot/ .claude/agents/analyste.md .claude/agents/tool-builder.md .claude/agents/detectors-critic.md .claude/agents/detectors-upgrader.md .claude/agents/detectors-control.md .claude/agents/event-builder.md .claude/agents/releveur.md .claude/agents/ameliorateur.md vues-deplacements/contexte/events-learner.md run.md docs/ameliorations-processus.md`, seulement ceux que `git status --short` montre changés, message `Learn <STATION>: process fixes`. Garde la suite de ce skill telle que tu l'as lue au début.
|
|
|
|
## 7. Réponse finale
|
|
|
|
`python3 .claude/skills/events-learner/comparaison.py <dossier> <séance>` : la page de fin de séance, `out/events-learner_<SEANCE>_<STATION>.html`, qui s'ouvre dans le navigateur (D-066). C'est la page de `python3 detectors-view/detecteurs.py <dossier> --du <début> --au <fin>` sur la plage de la séance (images de la caméra et timelapse d'un événement au clic, pose de la caméra, `corr_x` et `corr_y` de chaque capteur, ligne « Error rate »), chaque ligne de catégorie dédoublée : la lecture de l'analyste (ses étiquettes) au-dessus des événements des détecteurs tels qu'ils sont en fin de séance, et en gris ses moments hors catégorie ; sous la figure, la liste des événements, le score de la séance et le benchmark sur la base d'events. Le but, séance après séance : que les deux coïncident. Un échec du script va dans la réponse, sans relance.
|
|
|
|
En 8 lignes au plus : la page, la base de la séance, le chemin du bilan, le benchmark (ligne `total` / `toutes`, `grep -E '^total +toutes'`, du début du lot à la modification gardée), le nombre de modifications gardées et d'events créés, le nombre d'étiquettes (`<séance>/lot-*/etiquettes.json`, à garder même si l'utilisateur annule des modifications : elles ne dépendent pas des détecteurs), les erreurs, les difficultés relevées et, avec `--ameliorer`, celles corrigées. Tout est sur `master`, rien n'est poussé : l'utilisateur annule ce qu'il ne garde pas par `git revert`.
|