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:
1 parent
79d83be3ff
commit
3b732adc52
169 files changed
+231
-288
No files matched your search
@@ -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
|
||||
|
||||
@@ -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
|
||||
|
||||
|
||||
@@ -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 ;
|
||||
|
||||
@@ -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__)
|
||||
@@ -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
|
||||
|
||||
|
||||
@@ -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
|
||||
|
||||
|
||||
@@ -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)
|
||||
|
||||
Reference in new issue
Block a user