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:
1 parent
21f8cd1db6
commit
c763cda5c3
24 files changed
+204
-86
No files matched your search
@@ -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.
|
||||
@@ -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__)
|
||||
Reference in new issue
Block a user