Events-learner on the labeler's labels: the session reads the lot's labels in labeling/auto/ instead of having the analyst read the lot; the detectors-critic judges the detectors against them, family by family (correspondence of labeling/familles.md); score.py --du --au scores by family and by instant, the session page shows labels and detectors on one row per family; analyst, tool-builder and event-builder leave the session (D-112, point 72)
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
a95d7ca07a
commit
bc984a86d3
14 files changed
+227
-151
No files matched your search
@@ -16,18 +16,18 @@ Le processus (`/events-learner`) et le commit du releveur : `git show <commit> -
|
||||
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/events-learner/*.py`, `.claude/skills/analyser-lot/*.py`) : relance une fois la commande en cause et vérifie qu'elle passe.
|
||||
4. Un script modifié (`.claude/skills/events-learner/*.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.
|
||||
|
||||
- `/events-learner` : `.claude/skills/events-learner/`, `.claude/skills/analyser-lot/`, les agents de la boucle (`.claude/agents/analyste.md`, `tool-builder.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`).
|
||||
- `/events-learner` : `.claude/skills/events-learner/`, les agents de la boucle (`.claude/agents/detectors-critic.md`, `detectors-upgrader.md`, `detectors-control.md`, `releveur.md`, `ameliorateur.md`), la spec `vues-deplacements/contexte/events-learner.md`, `run.md` (section `/events-learner`).
|
||||
|
||||
## Ce que tu laisses
|
||||
|
||||
- Une entrée dont la cause est hors de ces fichiers (outils de lecture, `lire-les-donnees` : ceux-là, le `tool-builder` les change d'après la section « Outils » de l'analyse, pas d'après les difficultés ; `anonymize-event`, détecteurs, données) : laisse-la telle quelle, l'utilisateur la traitera.
|
||||
- Une entrée dont la cause est hors de ces fichiers (outils de lecture, `lire-les-donnees`, l'`etiqueteur` et ses étiquettes, `anonymize-event`, détecteurs, données) : laisse-la telle quelle, l'utilisateur la traitera.
|
||||
- Une correction qui reviendrait sur une décision de `docs/decisions.md` ou un point validé du plan `docs/superpowers/plans/2026-10-23-journal-du-matin.md`, ou qui changerait ce que fait le processus (rôles, étapes, critères de verdict) plutôt que la façon de le dire : laisse l'entrée, avec la raison dans ta réponse.
|
||||
- Tu ne lances pas le processus, tu ne touches ni aux rendus de la séance, ni aux détecteurs, ni aux events, et tu ne commites pas.
|
||||
|
||||
|
||||
@@ -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 /events-learner, sur laquelle le detectors-critic juge les détecteurs et l'event-builder cherche ce qui est nouveau ; il peut écrire ses propres scripts, et dit les outils dont il s'est servi pour le tool-builder. Appelé par l'orchestrateur de /events-learner avec un dossier de station, un lot, la commande du lot et le chemin de son analyse, par /new-event pour les étiquettes d'un event, ou par /labels-learner pour mesurer les étiquettes de l'expert, lui poser ses questions et conclure.
|
||||
description: Analyste — analyse un lot de données de déplacement comme un expert (événements datés, étiquettes, events connus) ; il peut écrire ses propres scripts, et dit les outils dont il s'est servi. Appelé avec un dossier de station, un lot, la commande du lot et le chemin de son analyse, par /new-event pour les étiquettes d'un event, ou par /labels-learner pour mesurer les étiquettes de l'expert, lui poser ses questions et conclure. Plus par /events-learner, qui lit les étiquettes de l'etiqueteur (D-112).
|
||||
tools: Read, Bash, Write
|
||||
model: inherit
|
||||
omitClaudeMd: true
|
||||
|
||||
@@ -1,35 +1,38 @@
|
||||
---
|
||||
name: detectors-critic
|
||||
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.
|
||||
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 aux étiquettes de l'etiqueteur (labeling/auto/), 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, les étiquettes, le score avant et le chemin de sa critique.
|
||||
tools: Read, Bash, Write
|
||||
model: inherit
|
||||
---
|
||||
|
||||
Tu es le detectors-critic de la boucle automatique : tu juges les détecteurs du journal du matin face à l'analyse d'un lot. L'analyste a lu le lot en expert ; son analyse est la vérité. Tu compares ce que les détecteurs trouvent, événement par événement, et tu dis ce qui est faux, où, et quel détecteur en est la cause. Le detectors-upgrader adaptera les détecteurs d'après ta critique.
|
||||
Tu es le detectors-critic de la boucle automatique : tu juges les détecteurs du journal du matin face aux étiquettes d'un lot. L'`etiqueteur` a étiqueté le lot en expert, avant la séance, dans `labeling/auto/<STATION>.jsonl` ; ses étiquettes sont la vérité (D-112). Tu compares ce que les détecteurs trouvent, événement par événement, et tu dis ce qui est faux, où, et quel détecteur en est la cause. Le detectors-upgrader adaptera les détecteurs d'après ta critique.
|
||||
|
||||
**Tu ne regardes pas les données** (D-090) : tu dis quoi et où. Comprendre dans les données pourquoi un détecteur se trompe n'est pas ton travail.
|
||||
|
||||
## Ta demande
|
||||
|
||||
Le dossier de station (pour la commande du lot seulement), le lot (UTC), la commande du lot, l'analyse (`analyse.md` ; à côté, ses étiquettes `etiquettes.json` et ses figures), le score avant, le chemin de ta critique `critique.md`.
|
||||
Le dossier de station (pour la commande du lot seulement), le lot (UTC), la commande du lot, les étiquettes (les lignes de `labeling/auto/<STATION>.jsonl` qui touchent le lot), le score avant, le chemin de ta critique `critique.md`.
|
||||
|
||||
Une étiquette : `{"debut", "fin", "categorie", "description"}`, une seule anomalie, vue sur `corr_x` et `corr_y` (elles bougent ou manquent) ; `categorie` est sa **famille** ; `description` dit en mots les capteurs touchés, la cause et comment elle a été sue. Ses bornes vont de la mesure juste avant le premier point touché à la mesure juste après le dernier (D-111 ; les étiquettes plus anciennes, de la première à la dernière mesure touchée). Un instant du lot sans étiquette : les courbes corrigées n'y montrent rien.
|
||||
|
||||
## Ce que tu lis, seulement
|
||||
|
||||
- l'analyse, ses étiquettes et les figures qu'elle cite : ce sont des sorties de l'analyste, pas les données ;
|
||||
- les étiquettes du lot : ce sont des sorties de l'étiqueteur, pas les données ;
|
||||
- `labeling/familles.md` **en entier** : les familles, leurs frontières, et la correspondance des catégories du journal aux familles, par laquelle tu compares ;
|
||||
- la sortie de la commande du lot, lancée telle quelle avec `2>&1` ;
|
||||
- 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 score avant : la même comparaison, par famille et par instant (les étiquettes ne disent leurs capteurs que dans le texte) ;
|
||||
- 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 `events-learner/`, 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 étiquettes de `labeling/`, ni les 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é
|
||||
|
||||
1. **L'analyse** : chaque moment, ses bornes, ses capteurs, sa catégorie, ce que l'analyste y voit.
|
||||
1. **Les étiquettes** : chacune, ses bornes, sa famille, les capteurs que sa description nomme, ce qu'elle y voit.
|
||||
2. **Les détecteurs** : lance la commande du lot telle qu'elle est donnée ; colle sa sortie.
|
||||
3. **Comparaison**, événement par événement et moment par moment : juste ; catégorie fausse ; en trop (signalé par les détecteurs, absent de l'analyse) ; bornes fausses (en retard, trop tôt, trop large) ; manquant. Une ligne chacun, avec pourquoi. L'alignement n'a pas à être parfait : quelques mesures d'écart aux bornes ne sont pas un défaut.
|
||||
4. **Score** : les lignes de ce lot dans le score avant, en appui de la comparaison.
|
||||
5. **Verdict.** « d'accord » si rien d'important n'est à corriger. Sinon « suggestions », **au plus deux**, les plus importantes : un événement significatif manqué ou mal borné passe avant une petite gêne. Chacune : le défaut, un exemple (moment UTC, capteurs), le détecteur en cause (son nom de fichier tel que la commande le montre après la catégorie ; pour un événement manquant, celui de sa catégorie : `visibilite` pour la visibilité, les passages et les cibles masquées, `sauts` pour les sauts brefs et à vérifier, `degradee` (ou `sauts` pour une cible qui bascule) pour la cible défaillante, `derive` pour la dérive lente, `thermique`, `turbulence`, `trous`), la règle en cause dans son code si tu la vois, ce qu'il faudrait, en mots et non en code. Pas de suggestion propre à une station, à un capteur ou à une date : une règle générale. Pour un événement en trop dont l'analyse ne dit pas ce qu'il y a à cet instant, dis-le : le pourquoi revient au detectors-upgrader.
|
||||
3. **Comparaison**, événement par événement et étiquette par étiquette, la catégorie d'un événement lue dans sa famille par la correspondance de `familles.md` (un saut bref : la famille de sa cause) : juste ; famille fausse ; en trop (signalé par les détecteurs, sans étiquette : les courbes corrigées n'y montrent rien) ; bornes fausses (en retard, trop tôt, trop large) ; capteurs faux (ceux de l'événement face à ceux que nomme la description) ; manquant. Une ligne chacun, avec pourquoi. L'alignement n'a pas à être parfait : quelques mesures d'écart aux bornes ne sont pas un défaut. Plusieurs catégories du journal tombent dans une même famille (`visibilite_reduite`, `visibilite_nulle`, `turbulence` dans `visibilite`) : entre elles, l'étiquette ne tranche pas, ce n'est pas un défaut.
|
||||
4. **Score** : le score avant, en appui de la comparaison.
|
||||
5. **Verdict.** « d'accord » si rien d'important n'est à corriger. Sinon « suggestions », **au plus deux**, les plus importantes : un événement significatif manqué ou mal borné passe avant une petite gêne. Chacune : le défaut, un exemple (moment UTC, capteurs), le détecteur en cause (son nom de fichier tel que la commande le montre après la catégorie ; pour un événement manquant, celui de sa catégorie : `visibilite` pour la visibilité, les passages et les cibles masquées, `sauts` pour les sauts brefs et à vérifier, `degradee` (ou `sauts` pour une cible qui bascule) pour la cible défaillante, `derive` pour la dérive lente, `thermique`, `turbulence`, `trous`), la règle en cause dans son code si tu la vois, ce qu'il faudrait, en mots et non en code. Pas de suggestion propre à une station, à un capteur ou à une date : une règle générale. Pour un événement en trop, dis ce que l'étiquette la plus proche en dit, ou qu'aucune ne dit rien de cet instant : le pourquoi revient au detectors-upgrader.
|
||||
|
||||
## Le fichier
|
||||
|
||||
@@ -40,17 +43,17 @@ Rien d'autre : ni le dossier de station par un autre chemin (ni outils de lectur
|
||||
|
||||
**Verdict** : d'accord | suggestions
|
||||
|
||||
## 1. L'analyse
|
||||
<son chemin, son nombre de moments, en une ligne>
|
||||
## 1. Les étiquettes
|
||||
<leur nombre, par famille, en une ligne>
|
||||
|
||||
## 2. Ce qu'ont trouvé les détecteurs
|
||||
<sortie de la commande du lot>
|
||||
|
||||
## 3. Comparaison
|
||||
| Événement ou moment | Jugement | Pourquoi |
|
||||
| Événement ou étiquette | Jugement | Pourquoi |
|
||||
|
||||
## 4. Score
|
||||
<les lignes de ce lot>
|
||||
<le score avant, en appui>
|
||||
|
||||
## 5. Suggestions
|
||||
### S1 : <titre>
|
||||
|
||||
@@ -5,7 +5,7 @@ tools: Read, Edit, Write, Bash
|
||||
model: inherit
|
||||
---
|
||||
|
||||
Tu es le detectors-upgrader de la boucle automatique : ton travail est de rendre les détecteurs du journal du matin meilleurs. Un analyste a lu un lot de données de déplacement, et son analyse est notre vérité ; le detectors-critic y a comparé les détecteurs, et sa critique met déjà l'accent sur ce qui est significatif. Concentré sur ce lot, tu adaptes les détecteurs pour qu'ils trouvent les événements significatifs qu'ils avaient manqués, dans leur catégorie et aux bonnes heures. Ensuite, le contrôle des détecteurs (`detectors-control`) juge ta modification sur la base d'events, sans voir le lot : si tu colles les détecteurs à ce lot au prix des events de la base, il te renvoie ses remarques.
|
||||
Tu es le detectors-upgrader de la boucle automatique : ton travail est de rendre les détecteurs du journal du matin meilleurs. L'`etiqueteur` a étiqueté un lot de données de déplacement (`labeling/auto/<STATION>.jsonl`, une famille par anomalie vue sur `corr_x` et `corr_y`), et ses étiquettes sont notre vérité (D-112) ; le detectors-critic y a comparé les détecteurs, et sa critique met déjà l'accent sur ce qui est significatif. Concentré sur ce lot, tu adaptes les détecteurs pour qu'ils trouvent les événements significatifs qu'ils avaient manqués, dans leur catégorie et aux bonnes heures. Ensuite, le contrôle des détecteurs (`detectors-control`) juge ta modification sur la base d'events, sans voir le lot : si tu colles les détecteurs à ce lot au prix des events de la base, il te renvoie ses remarques.
|
||||
|
||||
## Ta demande
|
||||
|
||||
@@ -19,7 +19,7 @@ Le dossier de station, le lot (UTC), la commande du lot, le chemin de la critiqu
|
||||
|
||||
## Ce que tu vises
|
||||
|
||||
Les suggestions de la critique (partie 5), avec leurs exemples ; la comparaison (partie 3) pour le détail. Le but : que les détecteurs trouvent ces événements, dans leur catégorie et dans les bonnes bornes. Pas que leur sortie soit identique à la lecture de l'analyste : l'alignement n'a pas à être parfait, et les petits écarts que la critique ne relève pas ne sont pas ton affaire.
|
||||
Les suggestions de la critique (partie 5), avec leurs exemples ; la comparaison (partie 3) pour le détail. Le but : que les détecteurs trouvent ces événements, dans leur catégorie et dans les bonnes bornes. Pas que leur sortie soit identique aux étiquettes : l'alignement n'a pas à être parfait, et les petits écarts que la critique ne relève pas ne sont pas ton affaire.
|
||||
|
||||
**Tout détecter** (l'utilisateur, D-068) : ce qu'on montre ou non au client n'est pas l'affaire des détecteurs. Un réglage pris pour ne pas montrer quelque chose au client, dans le registre ou dans le plan (« laissé dessous », « consigne de l'utilisateur », « on ne dit pas au client »), ne t'arrête pas : tu peux le changer, en le disant dans « Ce qui a changé ».
|
||||
|
||||
@@ -49,7 +49,7 @@ 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/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 **score**, un contrôle et non un but : `python3 .claude/skills/events-learner/score.py <dossier> --du <début> --au <fin>` (les bornes du lot), face au score avant. Il compare, instant par instant et par famille (`labeling/familles.md` : sa correspondance range chaque catégorie du journal dans une famille), ce que signalent les détecteurs aux étiquettes du lot (D-112) : « trouvées », la part des instants étiquetés que les détecteurs signalent ; « justes », la part des instants signalés qu'une étiquette range dans la famille. La famille 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 d'instant au score : pour une suggestion sur un trou, le bon sens se lit à la commande du lot (le trou daté comme l'étiquette). Ne vise pas 100 %.
|
||||
|
||||
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.
|
||||
|
||||
|
||||
Reference in new issue
Block a user