diff --git a/.claude/skills/analyser-lot/SKILL.md b/.claude/skills/analyser-lot/SKILL.md index 2077bf3..66e39e0 100644 --- a/.claude/skills/analyser-lot/SKILL.md +++ b/.claude/skills/analyser-lot/SKILL.md @@ -6,7 +6,7 @@ argument-hint: " [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. +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. Tes étiquettes servent au benchmark des détecteurs (`/new-event`, D-069). Tu lis les données comme l'`etiqueteur` (même documentation, mêmes outils, D-115) ; seul ton rendu diffère, aux catégories du journal. 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 @@ -16,23 +16,26 @@ Tu reçois : le dossier de station, le lot (début et fin, UTC), la commande du - `.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 ; +- `labeling/carte-des-etiquettes.md` (**en entier**) : les phénomènes de l'expert, ses règles de lecture, ses faux amis, le contexte des stations ; +- `labeling/familles.md` (**en entier**) : les familles des étiquettes de l'expert, leurs frontières ; +- `docs/displacement/domaine/chaine-de-mesure.md` : le mécanisme ; - `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 ». +Rien d'autre : ni `labeling/manual/`, ni `labeling/auto/`, 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 ` 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 /etiquettes.json`. +Ceux de `lire-les-donnees`, avec `--debut` et `--fin` du lot (une marge avant ou après si un phénomène lent le demande) et `--sortie ` pour tes figures. Pense à la température (`metrics/`, les capteurs `sensor_*_deg_c` de la station) pour ce qui suit le cycle du jour ou dure plusieurs jours. Ne recopie jamais les identifiants de `metrics/` (`SIM_CCID`, `ip_*`). Bash sert aussi à lancer la commande du lot et le contrôle de tes étiquettes, `python3 .claude/skills/analyser-lot/etiquettes.py /etiquettes.json`. **Tes propres outils** (D-097) : quand les outils ne montrent pas ce que tu cherches, écris tes scripts, dans `/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é 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 ». +1. **Ta lecture.** Lis le lot comme le dit `lire-les-donnees`, avec la base et les détecteurs si tu veux, et tes scripts. Pour chaque moment, cherche dans la carte des étiquettes le phénomène qui convient et vérifie sur les données et les images ce qu'elle dit qu'on doit y voir ; attention à ses faux amis (section 3). Un phénomène qu'elle ne connaît pas se garde aussi, sans forcer une cause. À chaque moment du tableau, ajoute la catégorie de la carte des événements 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). diff --git a/.claude/skills/labels-learner/analyste.md b/.claude/skills/labels-learner/analyste.md index 7490216..5cefe3e 100644 --- a/.claude/skills/labels-learner/analyste.md +++ b/.claude/skills/labels-learner/analyste.md @@ -11,6 +11,7 @@ Le phénomène, le fichier des étiquettes (une ligne chacune : `station`, `debu - `.claude/skills/lire-les-donnees/SKILL.md` (lis-le en premier) : tes outils ; - les dossiers de station des étiquettes, par ces outils ou tes scripts, et leurs images avec Read ; - `docs/displacement/domaine/chaine-de-mesure.md` : le mécanisme ; +- `labeling/carte-des-etiquettes.md` (**en entier**) et `labeling/familles.md` : les phénomènes déjà documentés, les familles et leurs frontières ; - `docs/domaine/colonnes-des-deplacements.md`, `docs/domaine/pieges-des-donnees.md` ; - `events/carte-des-evenements.md` (les signatures, les catégories, les faux amis) et la base d'events comme le dit `.claude/skills/read-event/SKILL.md`. @@ -18,12 +19,12 @@ Rien d'autre : ni `CLAUDE.md`, ni `docs/decisions.md`, ni les plans, ni les leç ## Tes outils -Ceux de `lire-les-donnees`, avec `--debut`, `--fin` (la plage de l'étiquette et une marge de ton choix : quelques heures, un jour ou plus pour un effet thermique) et `--sortie `. Tes scripts dans `/outils/`, bibliothèque standard, figures par `.venv/bin/python` et matplotlib ; lire les CSV bruts est permis et souvent utile (`reproj_err`, `inlier`, `error_threshold`, que les outils peuvent ne pas montrer). Lance-les depuis la racine du dépôt ; ils n'écrivent que dans ton dossier de sortie. +Ceux de `lire-les-donnees`, avec `--debut`, `--fin` (la plage de l'étiquette et une marge de ton choix : quelques heures, un jour ou plus pour un effet thermique) et `--sortie `. Tes scripts dans `/outils/`, bibliothèque standard, figures par `.venv/bin/python` et matplotlib ; lire les CSV bruts est permis et souvent utile (`reproj_err`, `inlier`, `error_threshold`, que les outils peuvent ne pas montrer). Pense à la température (`metrics/`, les capteurs `sensor_*_deg_c` de la station) pour ce qui suit le cycle du jour ou dure plusieurs jours ; ne recopie jamais les identifiants de `metrics/` (`SIM_CCID`, `ip_*`). Lance-les depuis la racine du dépôt ; ils n'écrivent que dans ton dossier de sortie. ## Déroulé 1. **Chaque étiquette** : lis-la, puis va dans les données de sa plage. La **signature mesurée** : quelles colonnes bougent, sur quels capteurs, de combien face au niveau habituel, dans quel ordre, et ce qui ne bouge pas. Ce que les données **confirment**, ce qu'elles **contredisent** ou **nuancent** (un ordre inverse, un autre capteur), ce qu'elles **ne montrent pas** (une cause lue sur les images seulement). -2. **La comparaison** : ce qui est commun à toutes les étiquettes (général), ce qui tient à une station ou à un ouvrage, ce qui ressemble sans avoir la même cause (un faux ami) ; et, face à la chaîne de mesure et à la carte, ce qu'elles disent déjà, ce qui leur manque, ce qu'elles disent de faux. +2. **La comparaison** : ce qui est commun à toutes les étiquettes (général), ce qui tient à une station ou à un ouvrage, ce qui ressemble sans avoir la même cause (un faux ami) ; et, face à la chaîne de mesure, à la carte des étiquettes et à celle des événements, ce qu'elles disent déjà, ce qui leur manque, ce qu'elles disent de faux. 3. **Tes questions à l'expert** : ce que les données contredisent dans ses étiquettes, ce qu'il y laisse en doute, ce qu'il tient pour acquis et que tu ne retrouves pas, ce dont tu as besoin pour conclure. Peu, précises, chacune avec l'étiquette qu'elle cite. Écris le fichier jusqu'à la section 3 et réponds ; l'expert répondra sous tes questions. 4. **Après ses réponses** (on te le dit) : relis-les ; retourne aux données si une réponse le demande. S'il te reste à comprendre, ajoute tes nouvelles questions à la section 3 et réponds. Sinon, écris la section 4. 5. **Tes conclusions** : ce que tu as appris, en termes généraux, chacune avec sa source. Ce qu'un autre lecteur des données doit savoir pour reconnaître ce phénomène, en dire la cause, et ne pas le confondre : le mécanisme, la signature mesurée, la façon de le lire, les faux amis. Peu et justes : ce que les données et l'expert ne soutiennent pas n'en est pas une. Tu ne choisis pas où elles iront : c'est le travail du documentaliste. diff --git a/docs/decisions.md b/docs/decisions.md index 5021bf1..c423927 100644 --- a/docs/decisions.md +++ b/docs/decisions.md @@ -1086,3 +1086,10 @@ Règles du journal : - **Pourquoi** : l'utilisateur, 2026-11-03 : utiliser les ressources de présentation d'AIMsight pour les trois rapports de situation (BREITHORN, MICHIGAN, NEBRASKA) ; ce sont des rapports sur tout le mois d'octobre ; un skill pour les prochaines présentations, qui garde les leçons de cette première série. - **Options écartées** : un .pptx (skill `document-skills:pptx`) : hors charte, la fabrique donne déjà la charte et les contrôles ; copier la charte dans ce dépôt (elle se met à jour dans la fabrique) ; générer `main.typ` par script depuis le Markdown (trois présentations seulement, le résumé demande un jugement) ; la mise en page « figure à gauche, texte à droite » du gabarit (les puces s'y chevauchent). - **Conséquence** : il faut Typst (≥ 0.14, dans `~/.local/bin`) et la fabrique sur le poste ; le source `main.typ` reste dans la fabrique, hors de git (elle n'est pas un dépôt) ; chaque diapositive porte « PROJET unversioned » tant qu'il n'y a pas de dépôt. + +## D-115 — 2026-11-03 — L'analyste lit les données comme l'étiqueteur +- **Statut** : active ; complète D-106 et D-112. +- **Décision** : l'analyste (`analyser-lot`, et ses consignes de `/labels-learner`) lit les données comme l'`etiqueteur`, qui est plus récent : mêmes outils (`lire-les-donnees`, ses scripts, les CSV bruts, la température de `metrics/`), même documentation (`labeling/carte-des-etiquettes.md` en entier, `labeling/familles.md`, `docs/displacement/domaine/chaine-de-mesure.md`, en plus de la carte des événements et de la base d'events), sans les étiquettes de l'expert ni celles de l'étiqueteur. Son rendu ne change pas : `etiquettes.json`, aux catégories du journal et aux bornes « première et dernière mesure touchées », contrôlé par `etiquettes.py`. `analyser-lot` ne se dit plus « la vérité de la boucle » (D-112). +- **Pourquoi** : l'utilisateur, 2026-11-03 : les deux agents doivent avoir les mêmes outils et lire les données aussi bien l'un que l'autre ; l'analyste ne lisait ni la carte des étiquettes ni la chaîne de mesure, donc il connaissait moins bien les phénomènes de l'expert et leurs faux amis. +- **Options écartées** : mesurer d'abord l'écart en lançant les deux agents sur un même lot (inutile selon l'utilisateur) ; aligner aussi le rendu sur les familles et les bornes de l'étiqueteur (casserait le benchmark des détecteurs, qui compare mesure par mesure aux catégories du journal) ; retirer à l'analyste la sortie des détecteurs (`/new-event` la lui interdit déjà). +- **Conséquence** : `analyser-lot` (introduction, sources, outils, étape 1) et `.claude/skills/labels-learner/analyste.md` (sources, outils, étape 2) sont réécrits.