--- name: events-learner description: Séance automatique d'amélioration des détecteurs du journal du matin, sur un lot d'une station déjà étiqueté par l'etiqueteur (labeling/auto/), la plage choisie par l'utilisateur (D-057, D-112) — detectors-critic, detectors-upgrader, detectors-control. Lancé par l'utilisateur seulement, avec /events-learner. disable-model-invocation: true argument-hint: "data/ [--du AAAA-MM-JJ] [--au AAAA-MM-JJ] [--ameliorer]" --- # events-learner : la boucle automatique Tu es l'orchestrateur. La vérité de la séance, ce sont les étiquettes du lot, écrites en amont par l'`etiqueteur` dans `labeling/auto/.jsonl` (D-106, D-112) ; tu appelles les trois 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//` (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 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 -- ` 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-tools/ labeling/auto/` ; 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 : à l'étape 4 (`annuler`) et au §4, donne tes chemins fichier par fichier, sans eux (`git diff --name-only HEAD -- ` liste ceux de la séance). - Dossier de séance : `events-learner/_/`, ci-dessous ``. ## 2. Le lot et ses étiquettes 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. Dossier du lot : `/lot-01/`, ci-dessous ``. **Commande du lot**, donnée telle quelle aux agents : `python3 detectors/categories.py `, plus `--du` et `--au` s'ils sont donnés. Exemple : `--du 2026-10-05 --au 2026-10-09`. **Les étiquettes du lot** : les lignes de `labeling/auto/.jsonl` qui touchent la plage, écrites avant la séance par l'`etiqueteur` (`@etiqueteur data/ du au `, lancé par l'utilisateur) : une étiquette par anomalie vue sur `corr_x` et `corr_y`, sa famille (`labeling/familles.md`) et sa description ; un instant sans étiquette veut dire que les courbes corrigées n'y montrent rien (D-111). Contrôle : `python3 .claude/skills/events-learner/score.py --du --au ` (les bornes du lot) ; s'il sort en erreur (« Aucune étiquette »), dis-le et arrête-toi, sans commit : le lot est à étiqueter d'abord. Tu ne modifies jamais ce fichier. ## 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\*\* :' `. Chaque commit se fait par chemin, `git add && git commit -m "" -- `, 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 `. 1. **Score et benchmark avant.** `python3 .claude/skills/events-learner/score.py --du --au > /score-avant.txt 2>&1` : les détecteurs du début de séance face aux étiquettes du lot, par famille et par instant (D-112). `python3 .claude/skills/events-learner/benchmark.py --seance --etape "lot-NN avant" > /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 `/ vues-deplacements/benchmark/historique.csv`, message `Learn lot NN: score and benchmark`. 2. **Detectors-critic** (`detectors-critic`), qui juge les détecteurs face aux étiquettes, sans regarder les données (D-090) : `Dossier : . Lot NN : → (UTC). Commande du lot : . Étiquettes : labeling/auto/.jsonl, celles qui touchent le lot. Score avant : /score-avant.txt. Écris /critique.md.` Commit `/`, message `Learn lot NN: critique ()`. Verdict `d'accord` : va au bilan (§5). 3. **Detectors-upgrader** (`detectors-upgrader`), passage K = 1, 2 ou 3. Avant le passage 1, note la **base du lot** : `git rev-parse HEAD`. `Dossier : . Lot NN : → (UTC). Commande du lot : . Critique : /critique.md. Score avant : /score-avant.txt. Benchmark avant : /benchmark-avant.txt. [Contrôle précédent : /validation-(K-1).md.] Passage K. Écris /modification-K.md.` Commit `detectors/ vues-deplacements/contexte/seuils-du-journal.md /`, message `Learn lot NN: modification K`. Puis, les détecteurs commités : `python3 .claude/skills/events-learner/benchmark.py --seance --etape "lot-NN modification K" > /benchmark-K.txt 2>&1` (commité avec la validation). 4. **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 : /modification-K.md. Benchmark : /benchmark-avant.txt → /benchmark-K.txt. Base : . Passage K sur 3. Écris /validation-K.md.` Commit `/ vues-deplacements/benchmark/historique.csv`, message `Learn lot NN: control K ()`. - `accepté` ou `garder` : va au bilan (§5). - `à reprendre` : retour à l'étape 3, passage K + 1. - `annuler` : `git checkout -- detectors/ vues-deplacements/contexte/seuils-du-journal.md`, commit de ces deux chemins, message `Learn lot NN: modification annulée`. Le score ne compte que ce lot ; le benchmark rejoue les events de la base, les cas de régression. ## 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. Ne relance pas un agent plus d'une fois. ## 5. Bilan `python3 .claude/skills/events-learner/score.py --du --au > /score-fin.txt 2>&1` : le score des détecteurs de fin de séance sur les mêmes étiquettes. 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 (D-092). `/bilan.md` : ```markdown # Séance : , → (UTC) Commits : sur `master`, depuis (`git log --oneline ..HEAD`) Étiquettes : `labeling/auto/.jsonl`, sur le lot (première ligne de `lot-01/score-avant.txt`). Score, par famille et par instant (D-112) : au début du lot `lot-01/score-avant.txt`, en fin de séance `score-fin.txt`. 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 : → . Page : `out/events-learner__.html`, les étiquettes face aux détecteurs, famille par famille (D-066) ; la refaire : `python3 .claude/skills/events-learner/comparaison.py --du --au `. | Lot | Dates (UTC) | Étiquettes | Critique | Modification | |---|---|---|---|---| | 01 | … → … | n | d'accord / suggestions (n) | aucune / gardée (K passages) / annulée / erreur | ## Suggestions non traitées <« Pas corrigé » des modifications ; suggestions d'un lot sans modification gardée> ## Erreurs aucune | ``` Commit `/bilan.md /score-fin.txt`, message `Learn : 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 : / : la section « Difficultés » de chaque rendu des lots, et « Erreurs » du bilan. Difficultés de l'orchestrateur : aucune | .` (D-060) Si `git status --short docs/ameliorations-processus.md` montre un changement : commit de ce chemin, message `Learn : process difficulties`. **Améliorateur** (`ameliorateur`), seulement avec `--ameliorer` et si le releveur a commité : `Processus : /events-learner. Commit du releveur : .`, 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/agents/detectors-critic.md .claude/agents/detectors-upgrader.md .claude/agents/detectors-control.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 : 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 --du --au ` : la page de fin de séance, `out/events-learner__.html`, qui s'ouvre dans le navigateur (D-066). C'est la page de `python3 detectors-view/detecteurs.py --du --au ` 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 »), une ligne par famille des étiquettes, dédoublée : les étiquettes du lot au-dessus des événements des détecteurs tels qu'ils sont en fin de séance, rangés dans la famille de leur 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 7 lignes au plus : la page, la base de la séance, le chemin du bilan, le nombre d'étiquettes du lot, le benchmark (ligne `total` / `toutes`, `grep -E '^total +toutes'`, du début du lot à la modification gardée), le nombre de modifications gardées, 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`.