- Every station's auto labels reviewed by an analyst (/review-auto-labels), then a cross-review per family across all stations (new skill /cross-review-labels), a finishing pass, and descriptions rewritten in words (no numeric values). - The three never-labeled ranges (WILDSTRUBEL 07/09-01/10, NORDEND 16/08-01/10) labeled and reviewed: 991 auto labels on 11 stations, labeling/controle.py at 0 errors. - Labeling knowledge gathered in labeling/: regles-d-etiquetage.md (new), familles.md (settled boundaries), connaissances/ (notes moved from docs/, links updated), the label map rebuilt from reviewed labels, events and cases; events tied to their stations (PS_DES_COUDRES is JUNGFRAU). The labeler and reviewers read only labeling/. - labels-map reads auto labels and events; decision D-130; living plan points 73-75. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
10 KiB
name, description, disable-model-invocation
| name | description | disable-model-invocation |
|---|---|---|
| labels-map | Écrire ou refaire la carte des étiquettes (labeling/carte-des-etiquettes.md) à partir des étiquettes revues (celles de l'expert, labeling/manual/, et les automatiques revues, labeling/auto/), des events (events/) et des cas de labeling/connaissances/ — les phénomènes, ce qu'on voit pour chacun, comment on en a su la cause, les règles de lecture et les faux amis, chaque phrase sourcée. Lancé par l'utilisateur, /labels-map, après une revue des étiquettes (/review-labels, /review-auto-labels, /cross-review-labels). | true |
La carte des étiquettes
Les étiquettes de l'expert (labeling/manual/<STATION>.jsonl, D-098, D-100) sont la base de connaissance bas niveau du projet : une plage, ce qu'il y voit, la cause et comment il l'a sue. Elles sont rangées par station et par date ; l'analyste, lui, cherche par phénomène. La carte les range pour lui : un phénomène par fiche, ce qu'on voit, comment trancher, ce qu'il faut en conclure, et les étiquettes qui le montrent. C'est avec elle que l'étiqueteur étiquette seul (labeling/auto/, D-102, D-106).
La carte est dérivée des étiquettes : elle se refait en entier à chaque passage, depuis les étiquettes du moment. Une correction se fait dans l'étiquette (labeling.py, /review-labels), jamais dans la carte seule.
1. Lire les étiquettes
Toutes les lignes de labeling/manual/*.jsonl (debut, fin, description, revue). N'entrent dans la carte que celles qui portent revue ; les autres sont listées en fin de carte, « en attente de revue », une ligne chacune. Lis-les toutes en entier avant d'écrire : un phénomène se reconnaît d'une station à l'autre. Plus les lignes de labeling/auto/*.jsonl qui portent revue : des étiquettes de l'etiqueteur relues par l'analyste (/review-auto-labels, /cross-review-labels, D-128, D-130) ; elles entrent dans la carte avec la même clé, mais l'expert prime : une contradiction avec lui va en section 6, pas dans la fiche. Elles sont près d'un millier : lis-les par famille (la table de la dernière revue croisée, labeling/auto/revue-croisee/<date>/outils/table.py), et pars des sections « Phénomènes » et « Nouveaux cas » des revues, qui les ont déjà rangées.
Les events et les cas : les events (events/INDEX.md, puis events/E-xxx/event.md, clé [E-xxx]) sont des cas de ces mêmes stations, aux noms codés : rattache chacun à sa station et à ses étiquettes par ses dates et sa signature, et cite-les ensemble. Les cas de labeling/connaissances/ (cas annotés par l'expert, incident de Barcelone, cycle thermique) entrent de même. Quand un event, l'expert et une étiquette automatique se lisent différemment, compile au plus près de la réalité : les données tranchent (lire-les-donnees), l'expert prime sauf si elles le démentent, et le point va en section 6 comme question à l'expert. Toute la connaissance métier du labeling est dans labeling/ : ce qu'un event apprend entre dans la carte.
Chaque étiquette a une clé courte, qui sert de source partout dans la carte : STATION JJ.MM HH:MM (son debut, UTC), par exemple NIEDERHORN 30.09 21:00.
2. Découper en phénomènes
Une étiquette peut en contenir plusieurs : une cause et sa conséquence sur les références (« deux phénomènes se combinent »), un effet de fond sous l'épisode principal (l'effet thermique sous des sauts), un fait permanent de la station. Note pour chaque étiquette les phénomènes qu'elle montre, le principal d'abord.
Un phénomène est ce qui arrive, au niveau où l'expert l'explique : « un passage cache des cibles » et « une référence perdue fait sauter la base » sont deux phénomènes, même quand le second suit le premier. Regroupe sous un même phénomène ce qui a le même mécanisme, quelle que soit la cause (camion, toile, buée : une référence écartée fait sauter la base de la même façon). La cause garde sa propre fiche quand l'expert la reconnaît à des signes à elle (le train, la pluie, la toile).
3. Écrire la carte
labeling/carte-des-etiquettes.md, réécrite en entier. En français, qualitative comme les étiquettes : des mots, pas de valeurs (D-103) ; quantifier est le travail de /labels-learner.
En tête, quatre lignes : ce qu'est la carte et pour qui ; sa source (le nombre d'étiquettes revues, de stations, la date du jour) ; qu'elle se refait par /labels-map et ne se corrige pas à la main ; le lien avec events/carte-des-evenements.md (l'autre carte, de tout ce qui peut arriver, vu ou non ; celle-ci ne dit que ce que l'expert a étiqueté).
1. Les phénomènes, rangés dans les six familles de la carte des événements (A pas de mesure, B la vue est gênée, C la cible a changé, D les références, E la caméra et son support, F l'ouvrage a bougé), plus G. Configuration de la station pour un état permanent. Une famille sans étiquette n'apparaît pas. Une fiche par phénomène :
### <Nom court du phénomène>
- **Ce qui se passe** : le mécanisme, en une ou deux phrases.
- **Ce qu'on voit** : par grandeur, seulement celles que les étiquettes citent, dans cet ordre : cibles (`error_value`, rejets, `corr_x`/`corr_y`, positions dans l'image), références, erreur de reprojection, mouvement de la caméra, températures, images.
- **Au fil du temps** : quand ça arrive (nuit, jour, d'un coup, peu à peu), combien de temps, comment ça revient.
- **La cause, et comment l'expert l'a sue** : vue (sur quelle image), ou déduite (de quoi) ; ou « non établie ».
- **Ce qu'on en conclut** : pour l'ouvrage et pour les mesures (rien à faire, zone à ignorer, à vérifier, intervention).
- **Variantes** : ce qui change d'une étiquette à l'autre (plus fort, moins de capteurs, combiné à autre chose).
- **Étiquettes** : toutes les clés de l'expert, la principale d'abord ; des automatiques, au plus six exemples, les plus nets, de stations différentes si possible, puis leur compte par station (« et 41 autres : NORDEND 22, WILDSTRUBEL 12, SNCF01 7 ») ; puis les events ; « (une station) » si toutes viennent de la même.
Chaque phrase vient d'une étiquette au moins ; quand elle n'en vient que d'une parmi plusieurs, sa clé suit la phrase entre crochets. Les mots de l'expert sont gardés, son incertitude aussi (« sans doute », « peut-être », « non établi ») : ne la change ni en certitude ni en doute.
2. Les règles de lecture de l'expert : ce qu'il applique au-delà d'un cas (comment juger un saut, ce que veut dire telle valeur, quoi regarder d'abord). Une ligne par règle, en gras, puis le pourquoi en une phrase et ses clés. Une règle est une phrase de l'expert à portée générale, au présent, sans le cas (« une error_value haute n'est pas un problème en soi, ce sont ses variations qui comptent ») ; la lecture d'un cas n'en est pas une, même répétée, et sa prudence reste (« suggère » reste « suggère »).
3. Faux amis : deux lectures opposées, la fausse d'abord : « X n'est pas Y quand… », ce qui les sépare, les clés. Tirés des étiquettes qui les opposent elles-mêmes (« ce n'est pas une panne », « ce qui peut surprendre », « contrairement à »). Un critère qui confirme un diagnostic n'est pas un faux ami : il va dans « Ce qu'on voit » de sa fiche.
4. Le contexte des stations : un tableau, une ligne par station : l'ouvrage, où sont la caméra et les références, ce qui revient dans ses étiquettes ; seulement ce que disent les étiquettes, et à sa fréquence (vu une fois n'est pas « souvent »). Il sert à lire les plages non étiquetées de ces stations ; ce n'est pas une règle pour les autres (pas de règle spécifique à un site).
5. Écarts avec la carte des événements : ce qu'une étiquette dit autrement que events/carte-des-evenements.md (un trait nouveau, un détecteur qui ne voit rien, une conclusion différente), un point chacun, avec la clé et la ligne de l'autre carte. Ne modifie pas l'autre carte : l'utilisateur tranche.
6. Ce que les étiquettes ne disent pas encore : les causes laissées non établies ou non dites ; les phénomènes vus sur une seule station, nommés un à un d'après les fiches marquées « (une station) » ; les familles de la carte des événements sans étiquette ; puis les étiquettes en attente de revue.
4. Contrôler avant de rendre
python3 .claude/skills/labels-map/controle.py: aucune clé inconnue, aucune étiquette revue absente ; chaque chiffre qui reste se justifie (nom de capteur, heure d'une image, « presque à 1 » de l'expert).- Relis chaque fiche phrase à phrase face au texte de ses clés. Ce qui s'y glisse le plus :
- une prudence de l'expert devenue un fait (« suggère », « plausible », « sans doute », « peut-être ») ;
- le jour ou la nuit tirés de l'heure UTC : la station peut être n'importe où, ne l'écris que si l'étiquette le dit ;
- une cause « inconnue » quand l'étiquette ne la dit pas : écris « non dite » ;
- une phrase qui ne vient que d'une étiquette parmi plusieurs, sans sa clé ;
- un fait d'une étiquette prêté à toutes celles de la fiche (« les références intactes », vrai pour les trains, pas pour l'araignée).
- Aucun identifiant (
SIM_CCID,ip,ip_*).
Puis rends à l'utilisateur, court : le nombre de phénomènes, de règles, de faux amis, d'écarts ; les étiquettes qui n'ont trouvé place qu'avec peine (un phénomène à elles seules, un découpage discutable). Le commit attend son accord.
Règles
- Tu n'écris que
labeling/carte-des-etiquettes.md; les étiquettes et la carte des événements ne se modifient pas ici. - Rien que ce que disent les étiquettes revues, les events et les cas de
labeling/connaissances/; les données seulement pour trancher une contradiction. La carte est la mémoire de ce qui a été étiqueté, pas une synthèse du projet. La carte des événements sert aux noms des familles, à ses faux amis et à la section 5. - Vocabulaire des conclusions :
confirmed/strongly supported/consistent with/possible/insufficient evidence/not observedquand il faut qualifier ; pas de pseudo-probabilités.