diff --git a/.claude/skills/critiquer-lot/SKILL.md b/.claude/skills/critiquer-lot/SKILL.md index d9dc34b..5ed2f87 100644 --- a/.claude/skills/critiquer-lot/SKILL.md +++ b/.claude/skills/critiquer-lot/SKILL.md @@ -14,8 +14,9 @@ Tu reçois : le dossier de station, le lot (début et fin, UTC), la commande du ## Ce que tu as le droit de lire, seulement -- le dossier de station, par tes outils, et ses images avec Read ; -- `docs/domaine/colonnes-des-deplacements.md` (lis-le en premier) et `docs/domaine/pieges-des-donnees.md` ; +- `.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 ; - `docs/displacement/domaine/carte-des-evenements.md` : ce qui peut arriver, en familles, et les catégories du journal (section 4) ; - à l'étape 4 seulement, jamais avant : `agents/diagnostic/cas/INDEX.md`, puis les fiches `cas.md` qu'il cite et leurs figures. @@ -23,21 +24,11 @@ Rien d'autre : ni `CLAUDE.md`, ni `docs/decisions.md`, ni les plans, ni rien dan ## Tes outils -Lance-les depuis la racine du dépôt ; ils rendent des valeurs, c'est toi qui juges. Instants : `2026-10-05T00:00Z`. - -| Commande | Ce qu'elle rend | -|---|---| -| `python3 agents/diagnostic/outils/inventaire.py ` | Fichiers, images (heures couvertes), période, cadence, mesures manquantes, capteurs (référence ou cible, seuil d'erreur, rejets) | -| `python3 agents/diagnostic/outils/resume.py [--colonne C] [--stat median\|min\|max] [--pas 1h] [--capteurs A,B] [--debut T] [--fin T]` | Niveau habituel de chaque capteur (médiane, MAD, min, max), puis un tableau par pas de temps. Colonnes : `error_value`, `corr_x`, `corr_y`, `relative_x`, `relative_y`, `x`, `y`, `sigma0`, `reproj_err` | -| `.venv/bin/python agents/diagnostic/outils/graphique.py [--capteurs A,B] [--colonnes C1,C2] [--debut T] [--fin T] [--zone T1/T2 ...] --sortie ` | Un PNG des séries, chaque `--zone` grisée ; **regarde-le avec Read** | -| `.venv/bin/python agents/diagnostic/outils/vignettes.py --capteurs A,B --heures T1,T2 [--rayon 100] --sortie ` | Gros plans des capteurs sur les images, à pleine résolution ; **regarde-la avec Read** | -| `ls /images/`, puis Read sur une image | L'image entière, pour la scène (occultation, éclairage, météo) | - -Bash ne sert qu'à lancer ces outils, la commande du lot, `ls`, `grep` et `date`. N'écris aucun autre script. +Ceux de `lire-les-donnees`, avec `--debut` et `--fin` du lot et `--sortie ` pour tes figures. Bash sert aussi à lancer la commande du lot. N'écris aucun autre script. ## Déroulé -1. **Ta lecture, sans les détecteurs.** Inventaire ; courbes du lot (`error_value`, puis `corr_x`, `corr_y` ou `relative_x`, `relative_y`, références et cibles) ; vignettes espacées, une toutes les 2 à 3 h, plus serrées là où les courbes bougent ; images entières pour la scène. Note chaque moment : début, fin, capteurs, ce que tu vois, la catégorie de la carte qui conviendrait, ou « aucune catégorie ». **Écris cette partie dans ton fichier avant l'étape 2.** +1. **Ta lecture, sans les détecteurs.** Lis le lot comme le dit `lire-les-donnees`. À chaque moment de son tableau, ajoute la catégorie de la carte qui conviendrait, ou « aucune catégorie ». **Écris cette partie dans ton fichier avant l'étape 2.** 2. **Les détecteurs.** Lance la commande du lot telle qu'elle est donnée ; colle sa sortie. 3. **Comparaison**, événement par événement et moment par moment : juste ; catégorie fausse ; en trop ; bornes fausses (en retard, trop tôt, trop large) ; manquant. Une ligne chacun, avec pourquoi. 4. **Cas connus**, après les faits : lis l'index, ouvre au plus 3 fiches proches de tes moments. Ce que la base connaît déjà, cas marqués « (appris) » compris. @@ -54,7 +45,7 @@ Bash ne sert qu'à lancer ces outils, la commande du lot, `ls`, `grep` et `date` **Verdict** : d'accord | suggestions ## 1. Ma lecture -| Début | Fin | Capteurs | Ce que je vois | Catégorie | +| Début | Fin | Capteurs | Colonnes | Ce que je vois | Images | Catégorie | ## 2. Ce qu'ont trouvé les détecteurs diff --git a/.claude/skills/lire-les-donnees/SKILL.md b/.claude/skills/lire-les-donnees/SKILL.md new file mode 100644 index 0000000..bf0b0dd --- /dev/null +++ b/.claude/skills/lire-les-donnees/SKILL.md @@ -0,0 +1,54 @@ +--- +name: lire-les-donnees +description: Lire un dossier de données de déplacement d'une station AIMsight, courbes et images, avec les outils de lecture — ce qu'ils rendent et comment s'en servir. Suivi par l'analyste (critiquer-lot), l'agent de diagnostic et le lecteur de /aiguiser ; amélioré par /aiguiser. +--- + +# Lire les données + +Une caméra suit des cibles (réflecteurs) fixées sur un ouvrage ; son propre mouvement est compensé grâce à des cibles de référence, supposées fixes. Ce skill dit comment lire les données d'une station : ce que montrent les courbes et les images, moment par moment. Il ne dit pas ce qu'elles veulent dire : catégorie, cas connu, hypothèse et verdict sont l'affaire de celui qui t'appelle. + +## À lire d'abord + +- `docs/domaine/colonnes-des-deplacements.md` : formats des exports et sens des colonnes (**en premier**) ; +- `docs/domaine/pieges-des-donnees.md`. + +## Les outils + +Lance-les depuis la racine du dépôt. Ils rendent des valeurs, jamais des verdicts : c'est toi qui juges. + +| Commande | Ce qu'elle rend | +|---|---| +| `python3 agents/diagnostic/outils/inventaire.py ` | Fichiers par type, images (heures couvertes), période, cadence, mesures manquantes, capteurs (référence ou cible, seuil d'erreur, mesures rejetées) | +| `python3 agents/diagnostic/outils/resume.py [--colonne C] [--stat median\|min\|max] [--pas 1h] [--capteurs A,B] [--debut T] [--fin T]` | Niveau habituel de chaque capteur sur toute la période (médiane, MAD, min, max), puis un tableau par pas de temps. Colonnes : `error_value`, `corr_x`, `corr_y`, `relative_x`, `relative_y`, `x`, `y`, `sigma0`, `reproj_err` | +| `.venv/bin/python agents/diagnostic/outils/graphique.py [--capteurs A,B] [--colonnes C1,C2] [--debut T] [--fin T] [--zone T1/T2 ...] [--sortie D]` | Un PNG des séries ; chaque `--zone` est grisée ; il imprime son chemin. **Regarde-le avec Read** : tu lis mieux un graphique qu'un tableau | +| `.venv/bin/python agents/diagnostic/outils/vignettes.py --capteurs A,B --heures T1,T2 [--rayon 100] [--sortie D]` | Une planche de vignettes à pleine résolution : une ligne par capteur, une colonne par heure, centrées sur la position brute (`x`, `y`) du capteur ; pixels non retouchés, l'éclat se compare d'une vignette à l'autre. **Regarde-la avec Read** : une image entière lue par Read est réduite, un petit réflecteur y devient illisible | +| `ls /images/`, puis Read sur `TZ_*.jpg` | L'image entière de la caméra à cette heure (UTC), pour la scène (occultation, éclairage, météo) | + +`--sortie ` : là où celui qui t'appelle range tes figures ; il te le donne. + +## Conventions + +- Instants : `2026-01-01T00:00Z` ; une heure sans fuseau est lue en UTC ; `--fin` inclut la minute indiquée. Sur un lot, `--debut` et `--fin` du lot. +- Bash ne sert qu'à lancer ces outils, `ls`, `grep` et `date`, une commande par appel, sans boucle `for` (un tube vers `grep` est permis) : les permissions sont accordées commande par commande. N'écris aucun autre script. Celui qui t'appelle peut ajouter des commandes à cette liste. +- Chaque PNG se regarde avec Read : un PNG que tu n'as pas regardé n'a rien montré. + +## La méthode + +1. **Inventaire** : ce qui est disponible, ce qui manque (fichiers, images, période, cadence, capteurs). +2. **Large d'abord** : `graphique.py` sur tous les capteurs, `error_value` puis `corr_x`, `corr_y` (ou `relative_x`, `relative_y`), références et cibles ; `resume.py` sur ces colonnes avec un pas large (6h ou 1d). +3. **Puis zoome** : `resume.py` à 1h ou 15min, et `graphique.py` sur les fenêtres et les capteurs qui bougent. +4. **Chaque capteur face à son propre niveau habituel** (sa médiane et sa MAD), jamais à un seuil absolu. +5. **Les images** : vignettes espacées, une toutes les 2 à 3 h, plus serrées là où les courbes bougent, toujours avec un capteur témoin non touché, à une heure avant, pendant et après (à la même heure de la journée si possible) ; l'image entière pour la scène (occultation, éclairage, météo). + +## Ce que la lecture rend + +Une ligne par moment. Un moment : un capteur ou un groupe de capteurs qui sort de son niveau habituel pendant une fenêtre que tu peux dater. + +| Début | Fin | Capteurs | Colonnes | Ce que je vois | Images | +|---|---|---|---|---|---| + +- **Capteurs** : références ou cibles, combien, lesquels. +- **Ce que je vois** : la forme (pic d'un pas, palier, montée lente, agitation), l'ampleur face au niveau habituel (en MAD ou en fois la médiane), le retour à la normale ou non, ce que font les autres capteurs. +- **Images** : ce que montrent les vignettes et l'image entière à ce moment, ou « pas d'image ». + +Heures en UTC. diff --git a/agents/diagnostic/instructions.md b/agents/diagnostic/instructions.md index 16f4a4a..17df1a1 100644 --- a/agents/diagnostic/instructions.md +++ b/agents/diagnostic/instructions.md @@ -14,6 +14,7 @@ Tu reçois un dossier de `data/` (ex. `data/PS_DES_COUDRES/`) et, parfois, une q Toute la connaissance du projet sur les déplacements, autant qu'il en faut pour ton cas : +- `.claude/skills/lire-les-donnees/SKILL.md` : tes outils et ta façon de lire les données (§3) ; - les fichiers du dossier fourni, par tes outils (§3), et ses images avec Read ; - `docs/domaine/` : `colonnes-des-deplacements.md`, formats des exports et sens des colonnes (**lis-le en premier**), `pieges-des-donnees.md`, `ce-que-mesure-la-station.md` ; - `docs/displacement/` : `cadrage.md` et les notes de `domaine/`, dont `carte-des-evenements.md` : ce qui peut arriver, en familles, et le sens des catégories des détecteurs (section 4) ; @@ -27,20 +28,15 @@ Pour un long fichier, trouve la section avec `grep -n '^#' `, puis lis- ## 3. Tes outils -Lance-les depuis la racine du dépôt. Ils rendent des valeurs, jamais des verdicts : c'est toi qui juges. +Ceux de `.claude/skills/lire-les-donnees/SKILL.md` (lis-le avant tout) : ce qu'ils rendent, leurs conventions et la façon de lire. En plus : | Commande | Ce qu'elle rend | |---|---| -| `python3 agents/diagnostic/outils/inventaire.py ` | Fichiers par type, images (heures couvertes), période, cadence, mesures manquantes, capteurs (référence ou cible, seuil d'erreur, mesures rejetées) | -| `python3 agents/diagnostic/outils/resume.py [--colonne C] [--stat median\|min\|max] [--pas 1h] [--capteurs A,B] [--debut T] [--fin T]` | Niveau habituel de chaque capteur sur toute la période (médiane, MAD, min, max), puis un tableau par pas de temps. Colonnes : `error_value`, `corr_x`, `corr_y`, `relative_x`, `relative_y`, `x`, `y`, `sigma0`, `reproj_err` | -| `.venv/bin/python agents/diagnostic/outils/graphique.py [--capteurs A,B] [--colonnes C1,C2] [--debut T] [--fin T] [--zone T1/T2 ...] [--sortie D]` | Un PNG des séries ; chaque `--zone` est grisée ; il imprime son chemin. **Regarde-le avec Read** : tu lis mieux un graphique qu'un tableau | -| `.venv/bin/python agents/diagnostic/outils/vignettes.py --capteurs A,B --heures T1,T2 [--rayon 100] [--sortie D]` | Une planche de vignettes à pleine résolution : une ligne par capteur, une colonne par heure, centrées sur la position brute (`x`, `y`) du capteur ; pixels non retouchés, l'éclat se compare d'une vignette à l'autre. **Regarde-la avec Read** : une image entière lue par Read est réduite, un petit réflecteur y devient illisible | | `python3 vues-deplacements/journal/categories.py ` | Les événements des détecteurs du journal du matin, une ligne chacun : début, fin, catégorie (sens : section 4 de la carte des événements), grisé (données à ignorer) ou gardé, nombre de capteurs. Des repères calculés, réglés sur les cas de la base : pars d'eux sans les juger ; ils ne disent ni quels capteurs, ni pourquoi | -| `ls /images/`, puis Read sur `TZ_*.jpg` | L'image entière de la caméra à cette heure (UTC), pour la scène (occultation, éclairage, météo) | Sans `--sortie`, les PNG vont dans `out/diagnostic/` : c'est ton brouillon d'exploration. Avec `--sortie ` (§6), ils deviennent des preuves du rapport. -Instants : `2026-01-01T00:00Z` (une heure sans fuseau est lue en UTC ; `--fin` inclut la minute indiquée). Bash ne sert qu'à lancer ces outils, `ls`, `grep`, `pdftotext` et `date`, une commande par appel, sans boucle `for` (un tube vers `grep` est permis) : les permissions sont accordées commande par commande. N'écris aucun autre script. +Bash sert aussi à lancer `categories.py` et `pdftotext`, aux mêmes règles que les outils (une commande par appel, sans boucle `for`). N'écris aucun autre script. ## 4. Déroulé @@ -49,8 +45,7 @@ Ton enquête est complète ; ton rapport ne garde que ce qui sert la conclusion. 1. **Inventaire** (`inventaire.py`) : ce qui est disponible, ce qui manque, et ce que ce manque empêche de conclure (par exemple, sans métriques système, un arrêt de la station ne peut pas être écarté). 2. **Repérage** : commence large, puis zoome. - les détecteurs (`categories.py`) d'abord : leurs événements sont un premier repérage, que tu précises avec tes outils ; - - `graphique.py` sur tous les capteurs, puis `resume.py` sur `error_value`, `corr_x`, `corr_y` avec un pas large (6h ou 1d), puis 1h ou 15min sur les fenêtres intéressantes ; - - compare chaque capteur **à son propre niveau habituel** (sa médiane et sa MAD), jamais à un seuil absolu ; + - puis lis la période comme le dit `lire-les-donnees` : large, puis zoom, chaque capteur face **à son propre niveau habituel** ; - un seuil de repérage (ex. « au-dessus de médiane + 6 MAD ») est un choix d'exploration : annonce-le, et ne t'en sers jamais comme critère de conclusion. 3. **Tri : anomalie ou non.** - Une **anomalie** : un capteur ou un groupe de capteurs sort de son propre comportement habituel pendant une fenêtre que tu peux dater.