8.4 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 de l'expert (labeling/manual/*.jsonl) — les phénomènes qu'il a étiquetés, ce qu'on voit pour chacun, comment il en a su la cause, ses règles de lecture et ses faux amis, chaque phrase sourcée par ses étiquettes. Lancé par l'utilisateur, /labels-map, après une revue des étiquettes (/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.
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** : les clés, la principale d'abord ; « (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 : ni la documentation, ni les données, ni les events ; la carte est la mémoire de l'expert, pas une synthèse du projet. La carte des événements ne sert qu'aux noms des familles 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.