Loop: the analyst analyses, a new detectors-critic critiques (D-090)

- analyste: the most precise analysis of the batch, detectors allowed as
  a tool; reading, labels, known events, novelties in analyse.md; skill
  critiquer-lot renamed analyser-lot.
- detectors-critic: compares the detectors to the analysis event by
  event, without looking at the data; verdict and at most two
  suggestions in critique.md, read by the detectors-upgrader.
- /boucle step 2, builder, review page, /new-event and score.py import
  follow.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-10-29 09:58:48 +01:00
1 parent 21f8cd1db6
commit c763cda5c3
24 files changed
+204 -86

No files matched your search

+82
View File
@@ -0,0 +1,82 @@
---
name: analyser-lot
description: 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 et ce qui est nouveau. Suivi par l'analyste de /boucle (et par /new-event pour les étiquettes d'un event), ou à la main sur un lot.
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 tes nouveautés deviennent des events. Tu ne juges pas les détecteurs. Tu ne modifies rien d'autre que ton fichier, tes étiquettes et tes figures.
## 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 `boucle/`, 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`. N'écris aucun autre script.
## 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 ».
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. **Nouveautés** : ce que ni la carte ni l'index ne décrivent ; chacune avec son moment, ses capteurs, ce qui la montre et la figure.
## Le fichier
Écris-le exactement sur ce plan ; le builder lit le titre « Nouveautés » tel quel.
```markdown
# 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
## Nouveautés
aucune | - <moment, capteurs, ce qui le montre, figure>
## 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, qui ne voit pas les données, doit savoir pour juger les détecteurs : 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.
## 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.
```json
{"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_degradee` ; 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 3 lignes : le nombre de moments (étiquettes), de nouveautés, le chemin du fichier.
+123
View File
@@ -0,0 +1,123 @@
"""Étiquettes d'un lot : la lecture de l'analyste, moment par moment, dans un format qu'un script relit (point 44 du plan
du journal du matin, D-061) : la matière d'un futur modèle appris. Ce script contrôle un fichier ; il ne juge rien.
Un JSON par lot, <lot>/etiquettes.json :
{"station": "NORDEND", "debut": "2026-10-05T00:00Z", "fin": "2026-10-09T00:00Z", "moments": [
{"debut": "2026-10-08T02:30Z", "fin": "2026-10-09T00:00Z", "capteurs": ["PR17"], "categorie": "a_verifier",
"evenement": null, "preuve": "deduite", "description": "...", "apres_detecteurs": false}]}
- heures au format de donnees.iso ; capteurs : noms de la station, [] pour tous (contrat des détecteurs) ;
- categorie : une clé de la section 4 de la carte des événements, ou "aucune" ; evenement : le label du site d'une ligne
de sa section 1 (« Rain or fog »), ou null si la cause n'est pas établie ; la carte est la seule source du vocabulaire ;
- preuve : "vue" (sur les images) ou "deduite" (des courbes seules) ;
- apres_detecteurs : true pour un moment trouvé grâce aux détecteurs (vu dans leur sortie, puis vérifié dans les données).
Un instant du lot sans moment : l'analyste n'y a rien vu.
Usage : python3 .claude/skills/analyser-lot/etiquettes.py <dossier de station> <etiquettes.json>
python3 .claude/skills/analyser-lot/etiquettes.py --test
"""
import json
import os
import re
import sys
from datetime import datetime
RACINE = os.path.join(os.path.dirname(os.path.abspath(__file__)), "..", "..", "..")
sys.path.insert(0, os.path.join(RACINE, "agent-tools"))
from donnees import charger # noqa: E402
CARTE = os.path.join(RACINE, "events", "carte-des-evenements.md")
CHAMPS = {"debut", "fin", "capteurs", "categorie", "evenement", "preuve", "description", "apres_detecteurs"}
def vocabulaire():
"""Carte des événements -> (catégories du journal et "aucune", labels du site des événements)."""
texte = open(CARTE, encoding="utf-8").read()
s1, s4 = texte.split("## 1.")[1].split("## 2.")[0], texte.split("## 4.")[1]
cats = set(re.findall(r"^\| `(\w+)` \|", s4, re.M)) | {"aucune"}
evts = {c[1].strip() for ligne in s1.splitlines() if ligne.startswith("| ")
and len(c := ligne.split("|")[1:-1]) == 7 and not c[0].strip().startswith(("**", "Événement"))}
return cats, evts
def heure(v):
return datetime.strptime(v, "%Y-%m-%dT%H:%MZ") # TypeError, ValueError hors du format de donnees.iso
def defauts(lot, station, capteurs, cats, evts):
"""Étiquettes d'un lot -> défauts, une phrase chacun (aucun : le fichier est bon)."""
try:
debut, fin, moments = heure(lot["debut"]), heure(lot["fin"]), list(lot["moments"])
except (KeyError, TypeError, ValueError) as e:
return [f"en-tête : {type(e).__name__} {e} ; attendus : station, debut, fin (AAAA-MM-JJTHH:MMZ), moments"]
out = [] if lot.get("station") == station else [f"station {lot.get('station')!r}, le dossier est {station!r}"]
for i, m in enumerate(moments, 1):
def ko(msg):
out.append(f"moment {i} : {msg}")
if not isinstance(m, dict) or set(m) != CHAMPS:
ko(f"champs {sorted(m) if isinstance(m, dict) else m!r} ; attendus {sorted(CHAMPS)}")
continue
try:
d, f = heure(m["debut"]), heure(m["fin"])
if d > f:
ko("debut après fin")
elif f < debut or d > fin:
ko("hors du lot")
except (TypeError, ValueError):
ko(f"heures {m['debut']!r} → {m['fin']!r} : format AAAA-MM-JJTHH:MMZ")
if not isinstance(m["capteurs"], list) or (inconnus := [c for c in m["capteurs"] if c not in capteurs]):
ko(f"capteurs {m['capteurs']!r} : une liste de noms de la station, [] pour tous")
if m["categorie"] not in cats:
ko(f"categorie {m['categorie']!r} : une de {sorted(cats)}")
if m["evenement"] is not None and m["evenement"] not in evts:
ko(f"evenement {m['evenement']!r} : null ou un label du site de la section 1 de la carte")
if m["preuve"] not in ("vue", "deduite"):
ko(f"preuve {m['preuve']!r} : \"vue\" ou \"deduite\"")
if not isinstance(m["description"], str) or not m["description"].strip():
ko("description vide")
if not isinstance(m["apres_detecteurs"], bool):
ko("apres_detecteurs : true ou false")
return out
def controler(dossier, chemin):
try:
with open(chemin, encoding="utf-8") as f:
lot = json.load(f)
except (OSError, ValueError) as e:
print(f"{chemin} : illisible ({e})")
return 1
station = os.path.basename(os.path.normpath(dossier))
out = defauts(lot, station, set(charger(dossier)), *vocabulaire())
for d in out:
print(d)
print(f"{chemin} : {len(out)} défaut(s)" if out else f"{chemin} : bon, {len(lot['moments'])} moment(s)")
return 1 if out else 0
def test():
"""Deux moments réels de l'essai de l'analyste (NORDEND, lot 1, 2026-10-24), puis quatre fautes."""
dossier = os.path.join(RACINE, "vues-deplacements", "cas", "2026-10_NORDEND", "NORDEND")
args = ("NORDEND", set(charger(dossier)), *vocabulaire())
bon = {"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},
{"debut": "2026-10-08T02:30Z", "fin": "2026-10-09T00:00Z", "capteurs": ["PR17"], "categorie": "a_verifier",
"evenement": None, "preuve": "deduite", "description": "Saut durable de corr_y, sans retour.",
"apres_detecteurs": False}]}
assert defauts(bon, *args) == [], defauts(bon, *args)
faux = json.loads(json.dumps(bon))
faux["moments"][0]["capteurs"] = ["idem"]
faux["moments"][0]["categorie"] = "dilatation / contraction thermique"
faux["moments"][1]["fin"] = "2026-10-08T01:00Z"
del faux["moments"][1]["preuve"]
assert len(defauts(faux, *args)) == 3, defauts(faux, *args) # le champ manquant arrête le moment 2 : 2 + 1
print("test : bon")
if __name__ == "__main__":
if sys.argv[1:] == ["--test"]:
test()
elif len(sys.argv) == 3:
sys.exit(controler(*sys.argv[1:]))
else:
sys.exit(__doc__)