9.4 KiB
name, description, argument-hint
| name | description | argument-hint |
|---|---|---|
| analyser-lot | 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 (par /new-event pour les étiquettes d'un event), ou à la main sur un lot ; /events-learner lit désormais les étiquettes de l'etiqueteur (D-112). | <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, 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
Tu reçois : le dossier de station, le lot (début et fin, UTC), la commande du lot (sinon : python3 detectors/categories.py <dossier> --du <jour du début> --au <jour de la fin>), le chemin de ton analyse. Le dossier de ton analyse est <dossier de sortie> ci-dessous.
Ce que tu as le droit de lire, seulement
.claude/skills/lire-les-donnees/SKILL.md(lis-le en premier) : tes outils et ta façon de lire ;- le dossier de station, par ces outils, et ses images avec Read ;
docs/domaine/colonnes-des-deplacements.mdetdocs/domaine/pieges-des-donnees.md, que ce skill cite ;events/carte-des-evenements.md: ce qui peut arriver, en familles, les catégories du journal (section 4 : définition de chacune, éventualités du terrain qui la font, détecteurs ; D-074) et les faux amis (section 5) ;- 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 fichesevent.mdqu'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 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
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é
- Tes données.
inventaire.pysur 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. - 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 ». - Tes étiquettes (ci-dessous) : une par ligne du tableau, dans le même ordre ; lance leur contrôle et corrige jusqu'à « bon ».
- 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. - Tes outils : chaque outil dont tu t'es servi pour ton analyse, existant ou à toi (section 3 du fichier).
Le fichier
Écris-le exactement sur ce plan.
# Lot NN : <STATION>, <début> → <fin> (UTC)
## 1. Ma lecture
| Début | Fin | Capteurs | Colonnes | Ce que je vois | Images | Catégorie |
## 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. « 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
<dossier de sortie>/etiquettes.json : ta lecture sous une forme qu'un script relit, pour entraîner plus tard un modèle (D-061). Le lot entier est lu : un instant sans moment veut dire que tu n'y as rien vu.
{"station": "NORDEND", "debut": "2026-10-05T00:00Z", "fin": "2026-10-09T00:00Z", "moments": [
{"debut": "2026-10-08T01:00Z", "fin": "2026-10-08T02:45Z", "capteurs": ["PR01", "PR08", "PR02"],
"categorie": "visibilite_reduite", "evenement": "Rain or fog", "preuve": "vue",
"description": "Gouttes floues sur la vitre ; PR01 et PR08 rejetés.", "apres_detecteurs": false}]}
station: le nom du dossier de station ;debut,fin: le lot ; toutes les heures en UTC, au formatAAAA-MM-JJTHH:MMZ.- Les bornes d'un moment sont la première et la dernière mesure touchées, au quart d'heure près : un score les compare, mesure par mesure, à celles des détecteurs (D-062). Un saut qui dure (
a_verifier) : la mesure du saut seule, pas la période décalée qui suit. capteurs: les noms exacts, tous écrits (pas de « idem », pas de « références ») ;[]seulement si tous les capteurs sont touchés.categorie: la clé de la section 4 de la carte (visibilite_reduite…), ou"aucune", seulement pour ce qui ne touche pas les courbes (début d'export, petite bosse d'error_valuesans rejet ni effet surcorr) ; une plage sans aucun export n'est pas étiquetée. Ce qui change les courbes sans explication va dansa_verifier(règle de l'utilisateur, D-074 : ne pas alarmer le client) ; une cible constamment problématique (souvent rejetée, collée, qui bascule ou glisse sans cesse) danscible_a_probleme; un mouvement de la caméra par la chaleur, compensé, dansdilatation_thermiqueoucontraction_thermique.evenement: le « Label du site » de la ligne de la section 1 de la carte qui dit la cause ("Rain or fog","Spider web"), ounullsi la cause n'est pas établie.preuve:"vue"si les images la montrent,"deduite"si elle vient des courbes seules.description: ta colonne « Ce que je vois », en une ou deux phrases.apres_detecteurs:truepour un moment que tu as trouvé grâce aux détecteurs (vu dans leur sortie, puis vérifié dans les données),falsesinon.
Ta réponse
Après avoir écrit le fichier, réponds en 2 lignes : le nombre de moments (étiquettes), le chemin du fichier.