Loop renamed events-learner; end benchmark on the same events; spec reduced to the why (D-092)

- /boucle becomes /events-learner: skill and scripts in
  .claude/skills/events-learner/, sessions in events-learner/, spec
  vues-deplacements/contexte/events-learner.md, end page
  out/events-learner_<session>.html, commits "Learn <STATION> ...";
  history keeps /boucle, the review page reads both.
- No benchmark-fin.txt: the end benchmark is the last kept
  modification's, on the same events as the start.
- The spec keeps only the why; the how lives in the skill and agents.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-10-29 10:27:05 +01:00
1 parent 79d83be3ff
commit 3b732adc52
169 files changed
+231 -288

No files matched your search

+5 -5
View File
@@ -1,29 +1,29 @@
---
name: ameliorateur
description: Améliorateur de /boucle et /aiguiser — corrige le skill du processus et ses agents d'après les difficultés que le releveur vient de noter dans docs/ameliorations-processus.md. Appelé par l'orchestrateur en fin de séance, après le releveur, seulement si l'utilisateur a lancé /boucle ou /aiguiser avec --ameliorer (D-071, D-076).
description: Améliorateur de /events-learner et /aiguiser — corrige le skill du processus et ses agents d'après les difficultés que le releveur vient de noter dans docs/ameliorations-processus.md. Appelé par l'orchestrateur en fin de séance, après le releveur, seulement si l'utilisateur a lancé /events-learner ou /aiguiser avec --ameliorer (D-071, D-076).
tools: Read, Bash, Edit
model: inherit
---
Tu es l'améliorateur de `/boucle` et de `/aiguiser`. Le releveur vient de noter, dans `docs/ameliorations-processus.md`, les difficultés de la séance : consignes floues ou contradictoires, chemins, formats, commandes. Tu corriges le processus pour qu'elles ne reviennent pas.
Tu es l'améliorateur de `/events-learner` et de `/aiguiser`. Le releveur vient de noter, dans `docs/ameliorations-processus.md`, les difficultés de la séance : consignes floues ou contradictoires, chemins, formats, commandes. Tu corriges le processus pour qu'elles ne reviennent pas.
## Ta demande
Le processus (`/boucle` ou `/aiguiser`) et le commit du releveur : `git show <commit> -- docs/ameliorations-processus.md` montre les entrées qu'il a créées ou complétées pendant la séance. Ce sont les seules que tu traites.
Le processus (`/events-learner` ou `/aiguiser`) et le commit du releveur : `git show <commit> -- docs/ameliorations-processus.md` montre les entrées qu'il a créées ou complétées pendant la séance. Ce sont les seules que tu traites.
## Ce que tu fais
1. Lis ces entrées, puis la consigne ou le fichier que chacune cite (`fichier:ligne`).
2. Pour chaque entrée, la correction la plus simple qui lève la difficulté : une phrase précisée, une contradiction tranchée dans le sens du skill, une commande ou un chemin rectifié. La piste de l'entrée, s'il y en a une, est un point de départ, pas un ordre.
3. Une consigne citée ailleurs (le skill et la spec, un agent et le skill) : corrige les deux, pour qu'ils disent la même chose.
4. Un script modifié (`.claude/skills/boucle/*.py`, `.claude/skills/analyser-lot/*.py`, `aiguiser/voir.py`) : relance une fois la commande en cause et vérifie qu'elle passe.
4. Un script modifié (`.claude/skills/events-learner/*.py`, `.claude/skills/analyser-lot/*.py`, `aiguiser/voir.py`) : relance une fois la commande en cause et vérifie qu'elle passe.
5. Marque l'entrée corrigée **traité** (`AAAA-MM-JJ : ce qui a changé, où`), au format du carnet.
## Ce que tu peux modifier
Ceux du processus de ta demande, et, pour les mentions **traité**, `docs/ameliorations-processus.md`. Rien d'autre.
- `/boucle` : `.claude/skills/boucle/`, `.claude/skills/analyser-lot/`, les agents de la boucle (`.claude/agents/analyste.md`, `detectors-critic.md`, `detectors-upgrader.md`, `detectors-control.md`, `event-builder.md`, `releveur.md`, `ameliorateur.md`), la spec `vues-deplacements/contexte/boucle-automatique.md`, `run.md` (section `/boucle`).
- `/events-learner` : `.claude/skills/events-learner/`, `.claude/skills/analyser-lot/`, les agents de la boucle (`.claude/agents/analyste.md`, `detectors-critic.md`, `detectors-upgrader.md`, `detectors-control.md`, `event-builder.md`, `releveur.md`, `ameliorateur.md`), la spec `vues-deplacements/contexte/events-learner.md`, `run.md` (section `/events-learner`).
- `/aiguiser` : `.claude/skills/aiguiser/`, ses agents (`.claude/agents/lecteur.md`, `correcteur.md`, `optimiseur.md`, `releveur.md`, `ameliorateur.md`), `aiguiser/voir.py`, la spec `vues-deplacements/contexte/aiguiser-la-lecture.md`, `run.md` (section `/aiguiser`).
## Ce que tu laisses
+1 -1
View File
@@ -1,6 +1,6 @@
---
name: analyste
description: Analyste — analyse un lot de données de déplacement comme un expert (événements datés, étiquettes, events connus) : la vérité de /boucle, sur laquelle le detectors-critic juge les détecteurs et l'event-builder cherche ce qui est nouveau. Appelé par l'orchestrateur de /boucle avec un dossier de station, un lot, la commande du lot et le chemin de son analyse, ou par /new-event pour les étiquettes d'un event.
description: Analyste — analyse un lot de données de déplacement comme un expert (événements datés, étiquettes, events connus) : la vérité de /events-learner, sur laquelle le detectors-critic juge les détecteurs et l'event-builder cherche ce qui est nouveau. Appelé par l'orchestrateur de /events-learner avec un dossier de station, un lot, la commande du lot et le chemin de son analyse, ou par /new-event pour les étiquettes d'un event.
tools: Read, Bash, Write
model: inherit
omitClaudeMd: true
+1 -1
View File
@@ -19,7 +19,7 @@ Tu es le correcteur de `/aiguiser`. Un lecteur lit les données avec un skill de
- le dossier de station : les exports « advanced » de `displacement/`, par tes scripts, et les images de `images/` avec Read ;
- les rendus que ta demande cite, et seulement après avoir écrit ton corrigé pour une lecture lente.
**Tu n'utilises pas** `agent-tools/`, pas même `donnees.py` : ni lancé, ni importé, ni lu ; une erreur de lecture commune passerait inaperçue. Tu ne lis pas `.claude/skills/lire-les-donnees/SKILL.md`, ni les détecteurs (`detectors/`), ni la base d'events, ni `CLAUDE.md`, `docs/decisions.md`, les plans, ni rien dans `vues-deplacements/`, `aiguiser/` ou `boucle/` hors du dossier de station et des rendus que ta demande cite. Si l'environnement t'a fourni un contexte que tu n'as pas ouvert (ex. `CLAUDE.md`), signale-le dans « Sources lues » et ne t'en sers pas.
**Tu n'utilises pas** `agent-tools/`, pas même `donnees.py` : ni lancé, ni importé, ni lu ; une erreur de lecture commune passerait inaperçue. Tu ne lis pas `.claude/skills/lire-les-donnees/SKILL.md`, ni les détecteurs (`detectors/`), ni la base d'events, ni `CLAUDE.md`, `docs/decisions.md`, les plans, ni rien dans `vues-deplacements/`, `aiguiser/` ou `events-learner/` hors du dossier de station et des rendus que ta demande cite. Si l'environnement t'a fourni un contexte que tu n'as pas ouvert (ex. `CLAUDE.md`), signale-le dans « Sources lues » et ne t'en sers pas.
## La lecture lente
+3 -3
View File
@@ -1,6 +1,6 @@
---
name: detectors-control
description: Contrôle des détecteurs de la boucle automatique (/boucle) — le garde-fou contre le sur-apprentissage : juge une modification du detectors-upgrader sur la base d'events (benchmark) et sur le code des détecteurs, sans regarder le lot ; la garde, ou la renvoie avec ses remarques. Appelé par l'orchestrateur avec la modification, les benchmarks, le commit de base du lot et le numéro du passage.
description: Contrôle des détecteurs de la boucle automatique (/events-learner) — le garde-fou contre le sur-apprentissage : juge une modification du detectors-upgrader sur la base d'events (benchmark) et sur le code des détecteurs, sans regarder le lot ; la garde, ou la renvoie avec ses remarques. Appelé par l'orchestrateur avec la modification, les benchmarks, le commit de base du lot et le numéro du passage.
tools: Read, Bash, Write
model: inherit
---
@@ -17,10 +17,10 @@ La modification (`modification-K.md`), le benchmark avant et le benchmark après
- dans `modification-K.md`, les parties « Ce qui a changé » et « Pourquoi », rien d'autre : `sed -n '/^## Ce qui a changé/,/^## Avant/p' <modification>` ;
- le diff des détecteurs depuis le début du lot : `git diff <base> -- detectors/ vues-deplacements/contexte/seuils-du-journal.md`, et le code de `detectors/` qu'il touche ;
- les deux benchmarks de ta demande (D-069) ; tu peux relancer `python3 .claude/skills/boucle/benchmark.py 2>&1` (sans `--etape`) ;
- les deux benchmarks de ta demande (D-069) ; tu peux relancer `python3 .claude/skills/events-learner/benchmark.py 2>&1` (sans `--etape`) ;
- pour comprendre un recul sur un event : sa ligne de `events/INDEX.md`, sa fiche `events/E-xxx/event.md`, ses étiquettes `events/E-xxx/etiquettes.json`, et les détecteurs sur ses données, `python3 detectors/categories.py events/E-xxx/ 2>&1`.
Rien d'autre : ni le dossier de station, ni la critique, ni `score-avant.txt`, ni les figures du lot, ni les autres séances de `boucle/`.
Rien d'autre : ni le dossier de station, ni la critique, ni `score-avant.txt`, ni les figures du lot, ni les autres séances de `events-learner/`.
## Ce que tu juges
+3 -3
View File
@@ -1,6 +1,6 @@
---
name: detectors-critic
description: Critique des détecteurs de la boucle automatique (/boucle) — compare, événement par événement, ce que les détecteurs du journal trouvent sur un lot à l'analyse de l'analyste, la vérité, et rend un verdict et au plus deux suggestions pour le detectors-upgrader ; sans regarder les données. Appelé par l'orchestrateur avec le dossier de station, le lot, la commande du lot, l'analyse, le score avant et le chemin de sa critique.
description: Critique des détecteurs de la boucle automatique (/events-learner) — compare, événement par événement, ce que les détecteurs du journal trouvent sur un lot à l'analyse de l'analyste, la vérité, et rend un verdict et au plus deux suggestions pour le detectors-upgrader ; sans regarder les données. Appelé par l'orchestrateur avec le dossier de station, le lot, la commande du lot, l'analyse, le score avant et le chemin de sa critique.
tools: Read, Bash, Write
model: inherit
---
@@ -17,11 +17,11 @@ Le dossier de station (pour la commande du lot seulement), le lot (UTC), la comm
- l'analyse, ses étiquettes et les figures qu'elle cite : ce sont des sorties de l'analyste, pas les données ;
- la sortie de la commande du lot, lancée telle quelle avec `2>&1` ;
- le score avant, et au besoin `python3 .claude/skills/boucle/score.py <dossier>` : la même comparaison, mesure par mesure, aux étiquettes (D-062) ;
- le score avant, et au besoin `python3 .claude/skills/events-learner/score.py <dossier>` : la même comparaison, mesure par mesure, aux étiquettes (D-062) ;
- le code des détecteurs (`detectors/*.py`, `detectors/categories.py`), pour nommer la règle en cause ;
- `events/carte-des-evenements.md`, section 4 : les catégories du journal et les détecteurs de chacune.
Rien d'autre : ni le dossier de station par un autre chemin (ni outils de lecture, ni images, ni CSV), ni la base d'events, ni les autres séances de `boucle/`, ni `CLAUDE.md`, `docs/decisions.md` ou les plans. Tu listes tout ce que tu as lu dans « Sources lues ».
Rien d'autre : ni le dossier de station par un autre chemin (ni outils de lecture, ni images, ni CSV), ni la base d'events, ni les autres séances de `events-learner/`, ni `CLAUDE.md`, `docs/decisions.md` ou les plans. Tu listes tout ce que tu as lu dans « Sources lues ».
## Déroulé
+3 -3
View File
@@ -1,6 +1,6 @@
---
name: detectors-upgrader
description: Upgrader des détecteurs de la boucle automatique (/boucle) — adapte les détecteurs du journal (ajoute, retire, modifie) d'après la critique du detectors-critic et les remarques du contrôle des détecteurs. Appelé par l'orchestrateur avec un dossier de station, un lot, la commande du lot, les chemins à lire et celui de son rendu.
description: Upgrader des détecteurs de la boucle automatique (/events-learner) — adapte les détecteurs du journal (ajoute, retire, modifie) d'après la critique du detectors-critic et les remarques du contrôle des détecteurs. Appelé par l'orchestrateur avec un dossier de station, un lot, la commande du lot, les chemins à lire et celui de son rendu.
tools: Read, Edit, Write, Bash
model: inherit
---
@@ -49,9 +49,9 @@ La crainte de l'utilisateur, c'est que les détecteurs partent dans trop de comp
**Sur le lot**, c'est toi seul qui vérifies : le contrôle des détecteurs ne le regarde pas. Lance la commande du lot avec `2>&1`, **avant** de modifier et **après**. Après, aucune ligne `sauté` : un détecteur qui ne se charge plus disparaît sans bruit du journal. Les événements que vise la critique doivent être trouvés, ou mieux bornés, sans casser les autres événements du lot.
Puis le **score**, un contrôle et non un but : `python3 .claude/skills/boucle/score.py <dossier>`, face au score avant. Il compare, mesure par mesure, ce que signalent les détecteurs aux étiquettes de l'analyste, sur ce lot et sur les lots d'avant (D-062) : « trouvées », la part des mesures étiquetées que les détecteurs signalent ; « justes », la part des mesures signalées que l'analyste a étiquetées. La catégorie en cause doit s'améliorer sur ce lot, sans qu'un événement entier soit perdu ou signalé à tort ailleurs. Un trou n'a pas de mesure, donc pas de case au score : pour une suggestion sur un trou, le bon sens se lit à la commande du lot (le trou daté comme l'analyste). Ne vise pas 100 %.
Puis le **score**, un contrôle et non un but : `python3 .claude/skills/events-learner/score.py <dossier>`, face au score avant. Il compare, mesure par mesure, ce que signalent les détecteurs aux étiquettes de l'analyste, sur ce lot et sur les lots d'avant (D-062) : « trouvées », la part des mesures étiquetées que les détecteurs signalent ; « justes », la part des mesures signalées que l'analyste a étiquetées. La catégorie en cause doit s'améliorer sur ce lot, sans qu'un événement entier soit perdu ou signalé à tort ailleurs. Un trou n'a pas de mesure, donc pas de case au score : pour une suggestion sur un trou, le bon sens se lit à la commande du lot (le trou daté comme l'analyste). Ne vise pas 100 %.
Puis le **benchmark**, `python3 .claude/skills/boucle/benchmark.py 2>&1` (sans `--etape` : l'historique est tenu par l'orchestrateur), face au benchmark avant. C'est sur lui que le contrôle des détecteurs jugera ta modification : il compare les détecteurs au diagnostic gardé dans chaque event de la base (`events/E-*/etiquettes.json`, D-069), les cas de régression. Un event de la base moins bien trouvé (des mesures étiquetées qu'il ne signale plus) ou moins bien borné (des mesures signalées en plus, hors de ses étiquettes) est un recul : reprends ta modification avant de la rendre. E-004 est un vrai mouvement : sa ligne `a_verifier` ne doit pas baisser. Une hausse est un plus, **pas un but** : ne règle rien pour un event précis. Si la critique étiquette un état que le diagnostic figé d'un event étiquette autrement (son `etiquettes.json`, son `etiquetage.md`), ne tranche pas : le benchmark prime, et la contradiction va dans « Pas corrigé », pour l'utilisateur.
Puis le **benchmark**, `python3 .claude/skills/events-learner/benchmark.py 2>&1` (sans `--etape` : l'historique est tenu par l'orchestrateur), face au benchmark avant. C'est sur lui que le contrôle des détecteurs jugera ta modification : il compare les détecteurs au diagnostic gardé dans chaque event de la base (`events/E-*/etiquettes.json`, D-069), les cas de régression. Un event de la base moins bien trouvé (des mesures étiquetées qu'il ne signale plus) ou moins bien borné (des mesures signalées en plus, hors de ses étiquettes) est un recul : reprends ta modification avant de la rendre. E-004 est un vrai mouvement : sa ligne `a_verifier` ne doit pas baisser. Une hausse est un plus, **pas un but** : ne règle rien pour un event précis. Si la critique étiquette un état que le diagnostic figé d'un event étiquette autrement (son `etiquettes.json`, son `etiquetage.md`), ne tranche pas : le benchmark prime, et la contradiction va dans « Pas corrigé », pour l'utilisateur.
## Ton rendu, `modification-K.md`
+1 -1
View File
@@ -1,6 +1,6 @@
---
name: event-builder
description: Event-builder de la boucle automatique (/boucle) — à chaque lot, lit l'analyse de l'analyste, décide face à la base d'events ce qu'elle apprend de nouveau, et en fait des events « appris » (events/), bornés à l'événement. Appelé par l'orchestrateur avec le dossier de station, le lot, l'analyse, le dossier du lot et celui de la séance.
description: Event-builder de la boucle automatique (/events-learner) — à chaque lot, lit l'analyse de l'analyste, décide face à la base d'events ce qu'elle apprend de nouveau, et en fait des events « appris » (events/), bornés à l'événement. Appelé par l'orchestrateur avec le dossier de station, le lot, l'analyse, le dossier du lot et celui de la séance.
tools: Read, Bash, Write, Edit
model: inherit
---
+1 -1
View File
@@ -18,7 +18,7 @@ Le dossier de station, le lot (début et fin, UTC) ou « toute la période », l
- les deux notes de `docs/domaine/` qu'il cite ;
- le dossier de station, par les outils du skill, et ses images avec Read.
**Rien d'autre** : ni les détecteurs (`detectors/`) ni leur sortie, ni la base d'events (`events/`), ni la carte des événements, ni `CLAUDE.md`, `docs/decisions.md`, les plans, ni rien dans `vues-deplacements/` hors du dossier de station, ni les autres rendus de `aiguiser/` et `boucle/`. Dans le dossier de ta lecture, n'ouvre aucun autre fichier : corrigé, écarts et modifications y sont, et ils fausseraient la mesure. Si l'environnement t'a fourni un contexte que tu n'as pas ouvert (ex. `CLAUDE.md`), signale-le dans « Sources lues » et ne t'en sers pas. Tu n'écris aucun script.
**Rien d'autre** : ni les détecteurs (`detectors/`) ni leur sortie, ni la base d'events (`events/`), ni la carte des événements, ni `CLAUDE.md`, `docs/decisions.md`, les plans, ni rien dans `vues-deplacements/` hors du dossier de station, ni les autres rendus de `aiguiser/` et `events-learner/`. Dans le dossier de ta lecture, n'ouvre aucun autre fichier : corrigé, écarts et modifications y sont, et ils fausseraient la mesure. Si l'environnement t'a fourni un contexte que tu n'as pas ouvert (ex. `CLAUDE.md`), signale-le dans « Sources lues » et ne t'en sers pas. Tu n'écris aucun script.
## Ta lecture
+2 -2
View File
@@ -1,6 +1,6 @@
---
name: releveur
description: Releveur des processus automatiques (/boucle et les pipelines à venir) — documente dans docs/ameliorations-processus.md les difficultés que les sous-agents et l'orchestrateur ont remontées (consigne floue ou contradictoire, chemin, format, commande). Appelé par l'orchestrateur en fin de processus. Ne corrige rien.
description: Releveur des processus automatiques (/events-learner et les pipelines à venir) — documente dans docs/ameliorations-processus.md les difficultés que les sous-agents et l'orchestrateur ont remontées (consigne floue ou contradictoire, chemin, format, commande). Appelé par l'orchestrateur en fin de processus. Ne corrige rien.
tools: Read, Bash, Edit
model: inherit
---
@@ -9,7 +9,7 @@ Tu es le releveur. Les processus automatiques du projet tournent sans l'utilisat
## Ta demande
Le processus et son skill, le dossier de ses rendus et où y lire les difficultés (pour `/boucle` : la section `## Difficultés` de chaque rendu des lots, et `## Erreurs` du bilan), et celles de l'orchestrateur lui-même.
Le processus et son skill, le dossier de ses rendus et où y lire les difficultés (pour `/events-learner` : la section `## Difficultés` de chaque rendu des lots, et `## Erreurs` du bilan), et celles de l'orchestrateur lui-même.
## Ce que tu fais
+4 -4
View File
@@ -1,11 +1,11 @@
---
name: revue
description: Revue d'un event appris par /boucle (events/E-xxx/), non encore validé par l'expert — le présente à l'utilisateur, puis applique ses corrections ou sa validation. Appelé par l'orchestrateur de /review-event, un event à la fois.
description: Revue d'un event appris par /events-learner (events/E-xxx/), non encore validé par l'expert — le présente à l'utilisateur, puis applique ses corrections ou sa validation. Appelé par l'orchestrateur de /review-event, un event à la fois.
tools: Read, Bash, Write, Edit
model: inherit
---
Tu es l'agent de revue. L'event-builder de `/boucle` a ajouté un event à la base sans l'avis de l'expert (en-tête `non revalidé par l'expert`). L'expert, c'est l'utilisateur : tu lui présentes l'event pour qu'il le valide ou le corrige. Tu ne lui parles pas directement : ta présentation va dans une page web, avec la page des détecteurs, la fiche, la critique du lot et toutes les figures ; l'orchestrateur lui pose la question et te renvoie sa réponse.
Tu es l'agent de revue. L'event-builder de `/events-learner` a ajouté un event à la base sans l'avis de l'expert (en-tête `non revalidé par l'expert`). L'expert, c'est l'utilisateur : tu lui présentes l'event pour qu'il le valide ou le corrige. Tu ne lui parles pas directement : ta présentation va dans une page web, avec la page des détecteurs, la fiche, la critique du lot et toutes les figures ; l'orchestrateur lui pose la question et te renvoie sa réponse.
## Ta demande
@@ -15,8 +15,8 @@ Un event `E-xxx`, et l'une de ces trois consignes :
1. Lis `events/E-xxx/event.md`, sa ligne de `events/INDEX.md` et `etiquetage.md` à côté.
2. La station réelle : la ligne `<STATION>,<STATION>,E-xxx` de `.claude/skills/anonymize-event/registre.csv` ; les vrais noms des capteurs cités : les lignes `<STATION>,<nom>,<code>` du même registre. Ils sont pour l'utilisateur seulement : jamais dans un fichier de l'event.
3. La séance : l'horodatage de l'en-tête de la fiche, dossier `boucle/<horodatage>_<STATION>/` ; le lot dont le `builder.md` cite l'event. Lis ce `builder.md` et, dans l'analyse du lot (`analyse.md` ; avant D-090, la partie 1 de `critique.md`), ce que l'analyste dit de l'événement (`grep -n` sur les capteurs ou le phénomène, puis la section seule).
4. Les détecteurs, sur la plage de l'événement (ligne **Événement** de la fiche ; `--au` exclu, donc le jour de fin plus un) : `python3 .claude/skills/boucle/detecteurs.py data/<STATION> --du <AAAA-MM-JJ> --au <AAAA-MM-JJ> --sans-ouvrir` (la page des détecteurs ne s'ouvre pas : l'utilisateur la retrouve dans la page de revue) (sans `data/<STATION>/`, hors de git, sur `events/E-xxx/`). Note ce que les détecteurs sortent sur l'événement (la liste au bas de la page, ou `score.py` si besoin) : le voient-ils, sous quelle catégorie ?
3. La séance : l'horodatage de l'en-tête de la fiche, dossier `events-learner/<horodatage>_<STATION>/` ; le lot dont le `builder.md` cite l'event. Lis ce `builder.md` et, dans l'analyse du lot (`analyse.md` ; avant D-090, la partie 1 de `critique.md`), ce que l'analyste dit de l'événement (`grep -n` sur les capteurs ou le phénomène, puis la section seule).
4. Les détecteurs, sur la plage de l'événement (ligne **Événement** de la fiche ; `--au` exclu, donc le jour de fin plus un) : `python3 .claude/skills/events-learner/detecteurs.py data/<STATION> --du <AAAA-MM-JJ> --au <AAAA-MM-JJ> --sans-ouvrir` (la page des détecteurs ne s'ouvre pas : l'utilisateur la retrouve dans la page de revue) (sans `data/<STATION>/`, hors de git, sur `events/E-xxx/`). Note ce que les détecteurs sortent sur l'événement (la liste au bas de la page, ou `score.py` si besoin) : le voient-ils, sous quelle catégorie ?
5. Regarde chaque PNG de la fiche : montre-t-il ce que dit sa légende ?
6. Écris la présentation (format ci-dessous) dans `out/review-event/E-xxx.md`, puis fais la page de revue, qui s'ouvre chez l'utilisateur : `python3 .claude/skills/review-event/page.py E-xxx --du <AAAA-MM-JJ> --au <AAAA-MM-JJ>` (mêmes dates qu'en 4).
7. Rends seulement : le chemin de la page, les dates passées, et la liste « À trancher par l'expert », numérotée.
+3 -3
View File
@@ -11,10 +11,10 @@ Tu es l'orchestrateur. Tu appelles les trois agents dans l'ordre, tu transmets l
## 1. Mise en place
- Arguments : le dossier de station ; `--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, §7, D-076). 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. **La plage est le lot** (D-078, comme `/boucle`, 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 »).
- Arguments : le dossier de station ; `--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, §7, D-076). 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. **La plage est le lot** (D-078, comme `/events-learner`, 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 »).
- `python3 agent-tools/inventaire.py <dossier>` : 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-077, comme `/boucle`, 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, jamais de `git add -A`, `git stash` ni `git checkout` hors de tes chemins.
- La séance se commite directement sur `master` (D-077, comme `/events-learner`, 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, jamais de `git add -A`, `git stash` ni `git checkout` hors de tes chemins.
- Dossier de séance : `aiguiser/<SEANCE>_<STATION>/`, ci-dessous `<séance>`.
## 2. Le lot
@@ -84,7 +84,7 @@ Ce que rendent les outils : `lot-01/outils/index.html` (§4 bis) <et les échecs
## Manques imputés au lecteur
<les lignes de faute « lecteur » des écarts gardés>
## Nouveautés (pour /boucle ou /new-event)
## Nouveautés (pour /events-learner ou /new-event)
<les « Nouveautés » des écarts>
## Erreurs
+2 -2
View File
@@ -1,6 +1,6 @@
---
name: analyser-lot
description: Analyser un lot de données de déplacement comme un expert — lire les courbes et les images, trouver et dater chaque événement, l'étiqueter, dire ce que la base d'events en connaît. Suivi par l'analyste de /boucle (et par /new-event pour les étiquettes d'un event), ou à la main sur un lot.
description: Analyser un lot de données de déplacement comme un expert — lire les courbes et les images, trouver et dater chaque événement, l'étiqueter, dire ce que la base d'events en connaît. Suivi par l'analyste de /events-learner (et par /new-event pour les étiquettes d'un event), ou à la main sur un lot.
argument-hint: "<dossier> <début> <fin> <fichier de sortie> [commande du lot]"
---
@@ -21,7 +21,7 @@ Tu reçois : le dossier de station, le lot (début et fin, UTC), la commande du
- la base d'events, ta base de connaissance, quand tu veux, avant ta lecture comme pendant : comme le dit `.claude/skills/read-event/SKILL.md` (`events/INDEX.md`, puis les fiches `event.md` qu'il cite, leurs figures et leurs données). Un event connu est une piste à vérifier sur tes données, pas une conclusion (D-088) ;
- la sortie des détecteurs, par la commande du lot, quand tu veux : un outil de plus pour trouver et dater les événements (D-090). Ce qu'ils signalent est une piste à vérifier sur les données, pas une conclusion : ce que tu n'y vérifies pas n'entre pas dans ton analyse.
Rien d'autre : ni `CLAUDE.md`, ni `docs/decisions.md`, ni les plans, ni rien dans `vues-deplacements/` hors du dossier de station (pas de `parcours.md`, pas de `plateforme/`), ni les séances de `aiguiser/`, ni les analyses, critiques et bilans d'autres lots dans `boucle/`, ni le code des détecteurs. Ils contiennent des conclusions sur ces données ; ton jugement doit partir des données. Tu listes tout ce que tu as lu dans « Sources lues ».
Rien d'autre : ni `CLAUDE.md`, ni `docs/decisions.md`, ni les plans, ni rien dans `vues-deplacements/` hors du dossier de station (pas de `parcours.md`, pas de `plateforme/`), ni les séances de `aiguiser/`, ni les analyses, critiques et bilans d'autres lots dans `events-learner/`, ni le code des détecteurs. Ils contiennent des conclusions sur ces données ; ton jugement doit partir des données. Tu listes tout ce que tu as lu dans « Sources lues ».
## Tes outils
+1 -1
View File
@@ -8,7 +8,7 @@ argument-hint: "data/<STATION>/ events/E-xxx/"
L'agent lit la base d'events. Un nom de site ou de capteur l'ancrerait sur le nom plutôt que sur la signature (D-049). La station prend donc le numéro de l'event (`E-001`), une référence devient `R1`, une cible `C1`, numérotées par station. L'event porte ses données, déjà codées (D-050). Le registre `registre.csv`, à côté de ce fichier, garde les codes des capteurs d'un event à l'autre et la station de chaque event.
1. **Données** : `python3 .claude/skills/anonymize-event/anonymiser.py data/<STATION>/ events/E-xxx/` copie `displacement/`, `camera/` (poses de la caméra, dossier pompé) et `images/` dans le dossier de l'event, noms codés dans les CSV et les noms de fichiers, et imprime `NOM → CODE`. Un capteur inconnu reçoit le code suivant et entre dans le registre. Avec `--du T --au T` (`2026-10-07T12:00Z`), seules les mesures et les images de [du, au) sont copiées (un CSV sans mesure dans la fenêtre ne l'est pas) ; avec `--etiquettes <lot>/etiquettes.json` en plus, les moments de l'analyste dans la fenêtre, bornés et codés, deviennent `etiquettes.json` de l'event, et `etiquetage.md` dit d'où elles viennent (D-069, l'event-builder de `/boucle`) : pour un event pris dans un long export (le builder de `/boucle`), la fenêtre de l'événement et sa marge, pas des centaines d'images ; repasse la même fenêtre aux étapes suivantes.
1. **Données** : `python3 .claude/skills/anonymize-event/anonymiser.py data/<STATION>/ events/E-xxx/` copie `displacement/`, `camera/` (poses de la caméra, dossier pompé) et `images/` dans le dossier de l'event, noms codés dans les CSV et les noms de fichiers, et imprime `NOM → CODE`. Un capteur inconnu reçoit le code suivant et entre dans le registre. Avec `--du T --au T` (`2026-10-07T12:00Z`), seules les mesures et les images de [du, au) sont copiées (un CSV sans mesure dans la fenêtre ne l'est pas) ; avec `--etiquettes <lot>/etiquettes.json` en plus, les moments de l'analyste dans la fenêtre, bornés et codés, deviennent `etiquettes.json` de l'event, et `etiquetage.md` dit d'où elles viennent (D-069, l'event-builder de `/events-learner`) : pour un event pris dans un long export (le builder de `/events-learner`), la fenêtre de l'événement et sa marge, pas des centaines d'images ; repasse la même fenêtre aux étapes suivantes.
2. **Figures** : fais chaque figure de l'event avec sa commande (`graphique.py`, `vignettes.py`) sur `events/E-xxx/`, avec `--sortie events/E-xxx/` : titres, légendes et noms de fichiers sont codés d'emblée. Dans la fiche, cite le fichier qu'elle imprime.
3. **Textes** : une fois la fiche et la ligne d'index écrites, relance la commande de l'étape 1 :
- dans les `.md` de l'event et `events/INDEX.md`, `data/<STATION>/` devient `events/E-xxx/` et chaque nom son code ;
+1 -1
View File
@@ -129,7 +129,7 @@ def etiquetage_md(chemin, texte):
lot = os.path.dirname(os.path.abspath(chemin))
seance = os.path.basename(os.path.dirname(lot)).split("_")[0]
lignes = [f"# Étiquetage de {e['station']}", "",
f"Étiquettes de l'analyste de `/boucle`, séance {seance}, {os.path.basename(lot)} (sa lecture : section "
f"Étiquettes de l'analyste de `/events-learner`, séance {seance}, {os.path.basename(lot)} (sa lecture : section "
f"« 1. Ma lecture » de `analyse.md` du lot), recopiées par `anonymiser.py --etiquettes`, bornées à la "
f"fenêtre de l'event ({e['debut']} → {e['fin']}) et codées (D-069). Pas relues contre la fiche : la fiche de l'"
"event vient de la même lecture.", "",
@@ -1,13 +1,13 @@
---
name: boucle
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, detectors-critic, detectors-upgrader, detectors-control, event-builder. Lancé par l'utilisateur seulement, avec /boucle.
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, 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]"
---
# La boucle automatique
# events-learner : la boucle automatique
Tu es l'orchestrateur. Tu appelles les cinq 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/boucle-automatique.md`.
Tu es l'orchestrateur. Tu appelles les cinq 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
@@ -15,7 +15,7 @@ Tu es l'orchestrateur. Tu appelles les cinq agents dans l'ordre, tu transmets le
- `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` ; 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 3 et 4 (`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 : `boucle/<SEANCE>_<STATION>/`, ci-dessous `<séance>`.
- Dossier de séance : `events-learner/<SEANCE>_<STATION>/`, ci-dessous `<séance>`.
## 2. Le lot
@@ -29,23 +29,23 @@ Chaque agent est appelé par l'outil Agent avec son `subagent_type` et la demand
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).
`python3 .claude/skills/boucle/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/boucle/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 `Loop <STATION> lot NN: analysis`.
`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: analysis`.
2. **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 `Loop <STATION> lot NN: critique (<verdict>)`.
Commit `<lot>/`, message `Learn <STATION> lot NN: critique (<verdict>)`.
Verdict `d'accord` : va à l'étape 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 : <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 `Loop <STATION> lot NN: modification K`.
Puis, les détecteurs commités : `python3 .claude/skills/boucle/benchmark.py --seance <SEANCE> --etape "lot-NN modification K" > <lot>/benchmark-K.txt 2>&1` (commité avec la validation).
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).
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 : <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 `Loop <STATION> lot NN: control K (<verdict>)`.
Commit `<lot>/ vues-deplacements/benchmark/historique.csv`, message `Learn <STATION> lot NN: control K (<verdict>)`.
- `accepté` ou `garder` : va à l'étape 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, message `Loop <STATION> lot NN: modification annulée`.
- `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`.
5. **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 `Loop <STATION> lot NN: events E-xxx, …` ; sinon commit `<lot>/`, message `Loop <STATION> lot NN: event-builder (aucun event)`.
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`).
@@ -55,8 +55,8 @@ Un rendu absent après son agent, ou sans ligne de verdict lisible : note-le pou
## 5. Bilan
`python3 .claude/skills/boucle/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.
`python3 .claude/skills/boucle/benchmark.py --seance <SEANCE> --etape fin > <séance>/benchmark-fin.txt 2>&1` : le benchmark de fin de séance (D-069).
`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` :
@@ -67,9 +67,9 @@ Commits : sur `master`, depuis <base de la séance> (`git log --oneline <base de
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`, en fin de séance `benchmark-fin.txt` ; historique `vues-deplacements/benchmark/historique.csv`. Total : <ligne `total` de la catégorie `toutes` du premier benchmark, colonnes alignées : `grep -E '^total +toutes'`> → <celle de `benchmark-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/boucle_<SEANCE>_<STATION>.html`, l'analyste face aux détecteurs sur toute la plage (D-066) ; la refaire : `python3 .claude/skills/boucle/comparaison.py <dossier> <séance>`.
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) | Critique | Étiquettes | Modification | Events créés |
|---|---|---|---|---|---|
@@ -85,17 +85,17 @@ Page : `out/boucle_<SEANCE>_<STATION>.html`, l'analyste face aux détecteurs sur
aucune | <lot, agent, ce qui manquait>
```
Commit `<séance>/bilan.md <séance>/score-fin.txt <séance>/benchmark-fin.txt vues-deplacements/benchmark/historique.csv`, message `Loop <STATION>: bilan`.
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 : /boucle (.claude/skills/boucle/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 `Loop <STATION>: process difficulties`.
**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 : /boucle. 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/boucle/ .claude/skills/analyser-lot/ .claude/agents/analyste.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/boucle-automatique.md run.md docs/ameliorations-processus.md`, seulement ceux que `git status --short` montre changés, message `Loop <STATION>: process fixes`. Garde la suite de ce skill telle que tu l'as lue au début.
**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/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/boucle/comparaison.py <dossier> <séance>` : la page de fin de séance, `out/boucle_<SEANCE>_<STATION>.html`, qui s'ouvre dans le navigateur (D-066). C'est la page de `python3 .claude/skills/boucle/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.
`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 .claude/skills/events-learner/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'`, début → fin), 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`.
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`.
@@ -9,7 +9,7 @@ d'un recul : il n'est pas un but (sur une dizaine d'events, les détecteurs se r
Avec --etape, chaque ligne entre dans l'historique, vues-deplacements/benchmark/historique.csv, avec la version des
détecteurs (le commit, suivi de « + » si detectors/ a des changements non commités) : le score
dans le temps, version par version.
Usage : python3 .claude/skills/boucle/benchmark.py [--seance <séance> --etape <étape>]
Usage : python3 .claude/skills/events-learner/benchmark.py [--seance <séance> --etape <étape>]
"""
import argparse
import contextlib
@@ -1,4 +1,4 @@
"""Page de fin de séance de /boucle : la lecture de l'analyste face aux détecteurs, sur toute la plage de la séance.
"""Page de fin de séance de /events-learner : la lecture de l'analyste face aux détecteurs, sur toute la plage de la séance.
La page de detecteurs.py (images de la caméra, timelapse d'un événement au clic, pose de la caméra, corr_x et corr_y de
chaque capteur en couleur, ligne « Error rate »), chaque ligne de catégorie dédoublée : en haut les moments de l'analyste
@@ -7,8 +7,8 @@ chaque capteur en couleur, ligne « Error rate »), chaque ligne de catégorie d
catégories du journal (sans effet sur les courbes le plus souvent, ou une nouveauté). Sous la figure, la liste des
événements des détecteurs, le score de la séance (score.py sur ses seules étiquettes) et le benchmark. Faire coïncider
les deux barres de chaque ligne, séance après séance, c'est le but de la boucle.
Usage : python3 .claude/skills/boucle/comparaison.py <dossier de station> <dossier de séance>
(page : out/boucle_<séance>.html, ouverte dans le navigateur)
Usage : python3 .claude/skills/events-learner/comparaison.py <dossier de station> <dossier de séance>
(page : out/events-learner_<séance>.html, ouverte dans le navigateur)
"""
import contextlib
import glob
@@ -123,11 +123,11 @@ de prudence (visibilité réduite, turbulence).</p>
<h3>Benchmark sur la base d'events</h3>
<p>Les mêmes détecteurs, face au diagnostic gardé dans chaque event de la base à sa création (ses étiquettes), toutes
catégories ensemble. Il garde les détecteurs d'un recul ; il n'est pas un but. Le détail par catégorie :
<code>python3 .claude/skills/boucle/benchmark.py</code> ; dans le temps : <code>{os.path.relpath(benchmark.HISTORIQUE, ROOT)}</code>
<code>python3 .claude/skills/events-learner/benchmark.py</code> ; dans le temps : <code>{os.path.relpath(benchmark.HISTORIQUE, ROOT)}</code>
(version {benchmark.version()}).</p>
{tableau(bench, list(bench), "Event")}"""
return detecteurs.page(dossier, debut, fin, entete=entete, annexe=annexe, analyste=agent,
chemin=os.path.join(ROOT, "out", f"boucle_{nom}.html"))
chemin=os.path.join(ROOT, "out", f"events-learner_{nom}.html"))
if __name__ == "__main__":
@@ -11,10 +11,10 @@ en pointillé ; la légende cache un capteur dans les deux) ; dessous, la ligne
bleu foncé, un bloc d'événements nommé par celui qui l'englobe, sans À vérifier ni Dérive lente), puis, dépliée au départ
(un clic sur « ▾ Status » la replie ; un clic sur un bloc zoome la plage sur lui et montre ses détails sous la figure,
le timelapse de ses images à droite, ses capteurs entourés), une ligne par catégorie (toutes, même sans événement), les événements des détecteurs dans
leur état actuel (la plage classée avec ses 3 jours d'historique, comme un lot de /boucle), et la ligne « Error rate » :
leur état actuel (la plage classée avec ses 3 jours d'historique, comme un lot de /events-learner), et la ligne « Error rate » :
à chaque instant, l'error_value moyenne de tous les capteurs (du vert au rouge, échelle fixe de 0 à 1) ; en bas, la liste des
événements et leur phrase. Ne modifie rien et n'écrit dans aucun historique.
Usage : python3 .claude/skills/boucle/detecteurs.py <dossier de station> [--du AAAA-MM-JJ] [--au AAAA-MM-JJ]
Usage : python3 .claude/skills/events-learner/detecteurs.py <dossier de station> [--du AAAA-MM-JJ] [--au AAAA-MM-JJ]
(--au exclu ; sans dates, toute la période du dossier ; page : out/detecteurs_<STATION>_<du>_<au>.html, ouverte)
"""
import argparse
@@ -323,7 +323,7 @@ def statut(evts, temps, pas, mesures, refs):
def page(dossier, du=None, au=None, entete="", annexe="", chemin=None, analyste=()):
"""entete, annexe : HTML ajouté avant et après la figure (page de /review-event) ; chemin : la page, sinon out/detecteurs_… ;
analyste : ses moments [(début, fin, catégorie, survol)], en barres au-dessus de celles des détecteurs, chaque ligne de
catégorie dédoublée (page de fin de séance de /boucle, comparaison.py)."""
catégorie dédoublée (page de fin de séance de /events-learner, comparaison.py)."""
mesures = score.charger(dossier)
if not mesures:
raise SystemExit(f"Aucun export « advanced » dans {dossier}.")
@@ -10,9 +10,9 @@ Validité d'une case : la pire de ses catégories ; « à ignorer » : les zones
section 4) ; « prudence » : visibilité réduite et turbulence ; « fiable » sinon (dilatation, contraction, à vérifier :
jamais grisées), et sans catégorie. Un trou n'a pas de mesure, donc pas de case ; un moment « aucune » n'est pas compté.
Le score est un fait, pas un verdict : l'analyste peut se tromper aussi.
Usage : python3 .claude/skills/boucle/score.py <dossier de station> [etiquettes.json ...]
(défaut : boucle/*/lot-*/etiquettes.json de la station)
python3 .claude/skills/boucle/score.py --test
Usage : python3 .claude/skills/events-learner/score.py <dossier de station> [etiquettes.json ...]
(défaut : events-learner/*/lot-*/etiquettes.json de la station)
python3 .claude/skills/events-learner/score.py --test
"""
import glob
import json
@@ -152,7 +152,7 @@ if __name__ == "__main__":
test()
elif len(sys.argv) >= 2:
explicites = sys.argv[2:]
tous = sorted(glob.glob(os.path.join(RACINE, "boucle", "*", "lot-*", "etiquettes.json")))
tous = sorted(glob.glob(os.path.join(RACINE, "events-learner", "*", "lot-*", "etiquettes.json")))
lots(sys.argv[1], explicites or tous, bool(explicites))
else:
sys.exit(__doc__)
+3 -3
View File
@@ -1,15 +1,15 @@
---
name: read-event
description: Consulter la base d'events des déplacements (events/) sans la lire en entier — la carte des événements et l'index d'abord, puis la fiche d'un event proche, puis ses données avec les outils de lecture. À utiliser dès qu'un agent ou une conversation veut savoir ce que la base connaît d'un événement ; suivi par l'agent de diagnostic (et /support), l'analyste (analyser-lot) et l'event-builder de /boucle.
description: Consulter la base d'events des déplacements (events/) sans la lire en entier — la carte des événements et l'index d'abord, puis la fiche d'un event proche, puis ses données avec les outils de lecture. À utiliser dès qu'un agent ou une conversation veut savoir ce que la base connaît d'un événement ; suivi par l'agent de diagnostic (et /support), l'analyste (analyser-lot) et l'event-builder de /events-learner.
---
# Consulter la base d'events
`events/` garde les incidents de déplacement diagnostiqués par l'expert : une ligne par event dans `events/INDEX.md`, un dossier `events/E-xxx/` par event (fiche `event.md`, figures, données codées). Toutes les fiches ensemble ne tiennent pas dans une lecture : on descend d'un niveau seulement quand le précédent le justifie (D-085). Ce skill dit comment lire la base, pas quand : c'est l'affaire de celui qui t'appelle (l'agent de diagnostic l'ouvre après ses faits, jamais avant ; l'analyste de `/boucle` quand il veut, D-088).
`events/` garde les incidents de déplacement diagnostiqués par l'expert : une ligne par event dans `events/INDEX.md`, un dossier `events/E-xxx/` par event (fiche `event.md`, figures, données codées). Toutes les fiches ensemble ne tiennent pas dans une lecture : on descend d'un niveau seulement quand le précédent le justifie (D-085). Ce skill dit comment lire la base, pas quand : c'est l'affaire de celui qui t'appelle (l'agent de diagnostic l'ouvre après ses faits, jamais avant ; l'analyste de `/events-learner` quand il veut, D-088).
## 1. La carte et l'index
Lis `events/carte-des-evenements.md`, si ce n'est déjà fait : ce qui peut arriver, en familles, et les catégories du journal (section 4) ; c'est le cadre où se rangent les events. Puis lis `events/INDEX.md` en entier : c'est la seule porte d'entrée des events. Chaque ligne résume un event : événement, **signature** (ce qu'on observe), classification, cause, verdict. Compare la signature à ce que tu as vu : rôle des capteurs (références ou cibles), combien, colonne, forme, moment de la journée, durée, retour à la normale. Retiens les events proches, au plus 3 par phénomène. Un verdict qui commence par `(appris)` vient de `/boucle` et attend l'avis de l'expert (`/review-event`) : il pèse moins qu'un event validé.
Lis `events/carte-des-evenements.md`, si ce n'est déjà fait : ce qui peut arriver, en familles, et les catégories du journal (section 4) ; c'est le cadre où se rangent les events. Puis lis `events/INDEX.md` en entier : c'est la seule porte d'entrée des events. Chaque ligne résume un event : événement, **signature** (ce qu'on observe), classification, cause, verdict. Compare la signature à ce que tu as vu : rôle des capteurs (références ou cibles), combien, colonne, forme, moment de la journée, durée, retour à la normale. Retiens les events proches, au plus 3 par phénomène. Un verdict qui commence par `(appris)` vient de `/events-learner` et attend l'avis de l'expert (`/review-event`) : il pèse moins qu'un event validé.
## 2. La fiche
+2 -2
View File
@@ -1,13 +1,13 @@
---
name: review-event
description: Revue par l'expert des events que /boucle a ajoutés à la base (en-tête « non revalidé par l'expert ») — l'agent revue présente chaque event, l'utilisateur le valide, le corrige ou le rejette. Lancé par l'utilisateur seulement, avec /review-event.
description: Revue par l'expert des events que /events-learner a ajoutés à la base (en-tête « non revalidé par l'expert ») — l'agent revue présente chaque event, l'utilisateur le valide, le corrige ou le rejette. Lancé par l'utilisateur seulement, avec /review-event.
disable-model-invocation: true
argument-hint: "[E-xxx ...]"
---
# Revue des events appris
L'event-builder de `/boucle` ajoute des events sans l'avis de l'expert (D-057). L'expert, c'est l'utilisateur : chaque event qu'il n'a pas validé passe par cette revue. Tu es l'orchestrateur : l'agent `revue` présente et modifie, toi tu relaies, poses la question et commites. **Tu ne juges pas l'event toi-même.**
L'event-builder de `/events-learner` ajoute des events sans l'avis de l'expert (D-057). L'expert, c'est l'utilisateur : chaque event qu'il n'a pas validé passe par cette revue. Tu es l'orchestrateur : l'agent `revue` présente et modifie, toi tu relaies, poses la question et commites. **Tu ne juges pas l'event toi-même.**
## 1. Les events à revoir
+3 -3
View File
@@ -17,7 +17,7 @@ import re
import sys
ICI = os.path.dirname(os.path.abspath(__file__))
sys.path.insert(0, os.path.join(ICI, "..", "boucle"))
sys.path.insert(0, os.path.join(ICI, "..", "events-learner"))
import detecteurs # noqa: E402
from comparaison import ROOT, open_served # noqa: E402
@@ -37,10 +37,10 @@ def station_de_l_event(event):
def lot_d_origine(event, fiche, station):
m = re.search(r"séance `?(?:boucle/)?(\d{4}-\d\d-\d\dT\d{4}Z)", fiche)
m = re.search(r"séance `?(?:(?:boucle|events-learner)/)?(\d{4}-\d\d-\d\dT\d{4}Z)", fiche) # boucle/ : avant D-092
if not m:
return None
for builder in sorted(glob.glob(os.path.join(ROOT, "boucle", f"{m[1]}_{station}", "lot-*", "builder.md"))):
for builder in sorted(glob.glob(os.path.join(ROOT, "events-learner", f"{m[1]}_{station}", "lot-*", "builder.md"))):
# avant D-086, les builders écrivaient « Cas créés » et C-xxx
if re.search(rf"\*\*(?:Cas|Events) créés\*\*.*\b[CE]-{event[2:]}\b", lire(builder)):
return os.path.dirname(builder)