Events-learner: the analyst writes its own tools, a tool-builder brings them into agent-tools; /aiguiser retired (D-097)

- inventaire.py: what each source contains on the window (filled or empty columns, metric names, images), names and counts only
- analyser-lot: step 0 on the data, own scripts in <lot>/outils/, section 3 "Outils"
- tool-builder (the optimiser, rewritten): after the analyst, optimises or adds reading tools, never removes; no control yet
- /aiguiser skill, reader, corrector and voir.py removed; its sessions and spec stay as history
- docs: D-097, specs, CLAUDE.md, run.md, README, plan point 56; the shared files also carry another session's pending edits (D-096 entry, plan points 57 to 67)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-10-29 17:10:17 +01:00
1 parent 52de2becbf
commit 7fb176cf0a
24 files changed
+555 -513

No files matched your search

+11 -4
View File
@@ -6,7 +6,7 @@ argument-hint: "<dossier> <début> <fin> <fichier de sortie> [commande du lot]"
# Analyser un lot
Tu lis, comme un expert, un lot de quelques jours d'une station AIMsight. Une caméra suit des cibles fixées sur un ouvrage ; son propre mouvement est compensé grâce à des références, supposées fixes. Une anomalie, c'est tout ce qui rend les courbes non plates : presque toujours un moment où il ne faut pas se fier aux données (pluie, buée, passage, toile, turbulence…), parfois un vrai mouvement. Ton travail : **l'analyse la plus précise possible** du lot, chaque événement trouvé, daté, rangé dans sa catégorie. Ton analyse est la vérité de la boucle : les détecteurs sont jugés sur elle par le `detectors-critic`, et l'`event-builder` y cherche ce qui est nouveau pour la base d'events. Tu ne juges pas les détecteurs. Tu ne modifies rien d'autre que ton fichier, tes étiquettes et tes figures.
Tu lis, comme un expert, un lot de quelques jours d'une station AIMsight. Une caméra suit des cibles fixées sur un ouvrage ; son propre mouvement est compensé grâce à des références, supposées fixes. Une anomalie, c'est tout ce qui rend les courbes non plates : presque toujours un moment où il ne faut pas se fier aux données (pluie, buée, passage, toile, turbulence…), parfois un vrai mouvement. Ton travail : **l'analyse la plus précise possible** du lot, chaque événement trouvé, daté, rangé dans sa catégorie. Ton analyse est la vérité de la boucle : les détecteurs sont jugés sur elle par le `detectors-critic`, l'`event-builder` y cherche ce qui est nouveau pour la base d'events, et le `tool-builder` y lit les outils dont tu t'es servi pour améliorer les outils de lecture (D-097). Tu ne juges pas les détecteurs. Tu ne modifies rien d'autre que ton fichier, tes étiquettes, tes figures et tes scripts.
## La demande
@@ -25,13 +25,17 @@ Rien d'autre : ni `CLAUDE.md`, ni `docs/decisions.md`, ni les plans, ni rien dan
## Tes outils
Ceux de `lire-les-donnees`, avec `--debut` et `--fin` du lot et `--sortie <dossier de sortie>` pour tes figures. Bash sert aussi à lancer la commande du lot et le contrôle de tes étiquettes, `python3 .claude/skills/analyser-lot/etiquettes.py <dossier> <dossier de sortie>/etiquettes.json`. N'écris aucun autre script.
Ceux de `lire-les-donnees`, avec `--debut` et `--fin` du lot et `--sortie <dossier de sortie>` pour tes figures. Bash sert aussi à lancer la commande du lot et le contrôle de tes étiquettes, `python3 .claude/skills/analyser-lot/etiquettes.py <dossier> <dossier de sortie>/etiquettes.json`.
**Tes propres outils** (D-097) : quand les outils ne montrent pas ce que tu cherches, écris tes scripts, dans `<dossier de sortie>/outils/`. Bibliothèque standard (`csv`, `datetime.fromisoformat`, `statistics`) ; figures par `.venv/bin/python` avec matplotlib, regardées avec Read. Ils lisent les CSV bruts du dossier de station ou passent par `agent-tools/donnees.py`, à ton choix : lire en brut peut montrer une erreur de la lecture commune, que les outils cachent à tous ceux qui lisent par eux. Lance-les depuis la racine du dépôt ; ils n'écrivent que dans ton dossier de sortie (ni `agent-tools/`, ni les skills, ni les données). Une sortie trop longue se range dans un fichier de ce dossier et se lit par `grep`, `head`, `tail` ou `sed -n`.
## Déroulé
1. **Ta lecture.** Lis le lot comme le dit `lire-les-donnees`, avec la carte, la base et les détecteurs si tu veux. À chaque moment de son tableau, ajoute la catégorie de la carte qui conviendrait, ou « aucune catégorie ».
0. **Tes données.** `inventaire.py` sur le lot (`--debut`, `--fin`) : les sources, ce que contient chacune (colonnes remplies ou vides, métriques système, images), la cadence, les capteurs. Comprends-les avant de chercher des événements : le sens des colonnes (`colonnes-des-deplacements.md`) ; une colonne remplie ou une source que les outils ne montrent pas, regarde-la par tes scripts si elle peut servir à ton analyse.
1. **Ta lecture.** Lis le lot comme le dit `lire-les-donnees`, avec la carte, la base et les détecteurs si tu veux, et tes scripts. À chaque moment de son tableau, ajoute la catégorie de la carte qui conviendrait, ou « aucune catégorie ».
2. **Tes étiquettes** (ci-dessous) : une par ligne du tableau, dans le même ordre ; lance leur contrôle et corrige jusqu'à « bon ».
3. **Events connus** : les events de la base proches de tes moments (`read-event` : l'index, puis au plus 3 fiches), consultés avant ou maintenant. Ce que la base connaît déjà, events « (appris) » compris.
4. **Tes outils** : chaque outil dont tu t'es servi pour ton analyse, existant ou à toi (section 3 du fichier).
## Le fichier
@@ -45,13 +49,16 @@ Ceux de `lire-les-donnees`, avec `--debut` et `--fin` du lot et `--sortie <dossi
## 2. Events connus
## 3. Outils
| Outil | Existant ou à moi | Pour quoi (moment, question) | Ce qu'il a montré | Ce qui a manqué ou encombré |
## Difficultés
aucune | - <ce qui a gêné ton travail : consigne floue, contradictoire ou absente qui t'a fait deviner, fichier ou chemin introuvable, format inattendu, commande qui échoue ; où, et ce que tu as fait à la place>
## Sources lues
```
« Ce que je vois » porte ce qu'un autre doit savoir pour juger les détecteurs sans voir les données, ou pour en faire un event : la forme, l'ampleur face au niveau habituel, le retour ou non, les capteurs témoins intacts, la caméra. « Difficultés » ne parle que du processus (consignes, chemins, outils), pas des données ni des détecteurs : un releveur les note pour l'utilisateur (D-060). Les figures sont dans le dossier de sortie, citées par leur nom. Heures en UTC.
« Ce que je vois » porte ce qu'un autre doit savoir pour juger les détecteurs sans voir les données, ou pour en faire un event : la forme, l'ampleur face au niveau habituel, le retour ou non, les capteurs témoins intacts, la caméra. « Outils » sert au `tool-builder`, qui ne voit que ce tableau, tes scripts et le lot : une ligne par outil qui t'a servi, existant (sa commande, ses options) ou à toi (le chemin de ton script, ce qu'il calcule, et dans « Ce qui a manqué ou encombré », pourquoi les outils existants ne suffisaient pas) ; « Ce qui a manqué ou encombré » : ce qu'il ne montrait pas, une sortie trop longue, une figure illisible, une option que tu as dû deviner ; « rien » sinon. « Difficultés » ne parle que du processus (consignes, chemins, commandes), pas des données, des détecteurs ni des outils de lecture : un releveur les note pour l'utilisateur (D-060). Les figures sont dans le dossier de sortie, citées par leur nom. Heures en UTC.
## Les étiquettes