- The labeler writes to its own folder (etiquettes.jsonl); labeling/auto/ only holds reviewed labels, merged by /review-auto-labels (new apply script: dated, sorted, checked). - labeling/controle.py also checks a proposed file; the labeler and reviewers run it before handing back. Reviewers keep their measurements in revue.md, never in the labels. - Reviewer instructions explicitly add their scripts, .venv/bin/python and for loops to the lire-les-donnees commands (the contradiction raised by 12 reviews). - Expert validation optional in /review-auto-labels; an expert hint given to the labeler is written in the labels it touches. Cross-review ends with the releveur. - docs/ameliorations-processus.md: 17 entries from this review, by the releveur. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
13 KiB
name, description, disable-model-invocation, argument-hint
| name | description | disable-model-invocation | argument-hint |
|---|---|---|---|
| events-learner | 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. | true | data/<STATION> [--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, relues et versées dans labeling/auto/<STATION>.jsonl (D-106, D-112, D-130) ; 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/<NOM EN MAJUSCULES>/(D-065) ;--du,--au(jours UTC, facultatifs : sans eux, toute la période ;--auest exclu : la plage s'arrête à--au00:00Z,--du 2026-09-01 --au 2026-09-05fait 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--lotou--tranchedonné quand même est ignoré (note-le sous « Erreurs »). Des dates écrites autrement (« 2026-09.01 », deux dates sans option) se lisent comme--dupuis--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-currentdoit diremaster, sinon dis-le et arrête-toi (pas degit 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 degit add -A,git stashnigit checkouthors 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 <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 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 : <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.
Les étiquettes du lot : les lignes de labeling/auto/<STATION>.jsonl qui touchent la plage, écrites avant la séance par l'etiqueteur (@etiqueteur data/<STATION> du <début> au <fin>, lancé par l'utilisateur) puis relues et versées par /review-auto-labels (D-130) : 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 <dossier> --du <début> --au <fin> (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\*\* :' <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>.
- Score et benchmark avant.
python3 .claude/skills/events-learner/score.py <dossier> --du <début> --au <fin> > <lot>/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 <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, messageLearn <STATION> lot NN: score and benchmark. - Detectors-critic (
detectors-critic), qui juge les détecteurs face aux étiquettes, sans regarder les données (D-090) :Dossier : <dossier>. Lot NN : <début> → <fin> (UTC). Commande du lot : <commande>. Étiquettes : labeling/auto/<STATION>.jsonl, celles qui touchent le lot. Score avant : <lot>/score-avant.txt. Écris <lot>/critique.md.Commit<lot>/, messageLearn <STATION> lot NN: critique (<verdict>). Verdictd'accord: va au bilan (§5). - 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.Commitdetectors/ vues-deplacements/contexte/seuils-du-journal.md <lot>/, messageLearn <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). - 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, messageLearn <STATION> lot NN: control K (<verdict>).acceptéougarder: va au bilan (§5).à reprendre: retour à l'étape 3, passage K + 1.annuler:git checkout <base du lot> -- detectors/ vues-deplacements/contexte/seuils-du-journal.md, commit de ces deux chemins, messageLearn <STATION> 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 <dossier> --du <début> --au <fin> > <séance>/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).
<séance>/bilan.md :
# 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`)
Étiquettes : `labeling/auto/<STATION>.jsonl`, <n> 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 : <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`, les étiquettes face aux détecteurs, famille par famille (D-066) ; la refaire : `python3 .claude/skills/events-learner/comparaison.py <dossier> <séance> --du <début> --au <fin>`.
| 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 | <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/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 <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> --du <début> --au <fin> : 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 »), 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.