- 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>
15 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 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. | true | 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 ;--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-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>.
- 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>/, messageLearn <STATION> lot NN: analysis. - 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 lignegrep '^\*\*Outils modifiés\*\* :' <lot>/tool-builder.mdva au bilan (colonne Outils). Commit de<lot>/et des chemins quegit status --porcelain -- agent-tools/ .claude/skills/lire-les-donnees/montre, sans les fichiers notés au début (§1), messageLearn <STATION> lot NN: tools (<ligne Outils modifiés>). Score et benchmark se calculent après lui : les détecteurs lisent paragent-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, messageLearn <STATION> lot NN: score and benchmark. - 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>/, messageLearn <STATION> lot NN: critique (<verdict>). Verdictd'accord: va à l'étape 6. - 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 à 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, messageLearn <STATION> lot NN: modification annulée.
- 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 pasaucun: commitevents/ .claude/skills/anonymize-event/registre.csv <lot>/, messageLearn <STATION> lot NN: events E-xxx, …; sinon commit<lot>/, messageLearn <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 :
# 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.