Files
Support-Agent/.claude/skills/analyser-lot/SKILL.md
T

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.md et docs/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 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 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é

  1. 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.
  2. 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 ».
  3. Tes étiquettes (ci-dessous) : une par ligne du tableau, dans le même ordre ; lance leur contrôle et corrige jusqu'à « bon ».
  4. 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.
  5. 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 format AAAA-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_value sans rejet ni effet sur corr) ; une plage sans aucun export n'est pas étiquetée. Ce qui change les courbes sans explication va dans a_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) dans cible_a_probleme ; un mouvement de la caméra par la chaleur, compensé, dans dilatation_thermique ou contraction_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"), ou null si 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 : true pour un moment que tu as trouvé grâce aux détecteurs (vu dans leur sortie, puis vérifié dans les données), false sinon.

Ta réponse

Après avoir écrit le fichier, réponds en 2 lignes : le nombre de moments (étiquettes), le chemin du fichier.