Labels map: the reviewed expert labels arranged by phenomenon for the analyst (labeling/carte-des-etiquettes.md), built by the /labels-map skill with its check script; first pass on 23 labels, 14 phenomena, reviewed against the labels and the skill strengthened (D-104)
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
d3b89a7f2e
commit
d47d29b04e
6 files changed
+336
-4
No files matched your search
@@ -0,0 +1,74 @@
|
||||
---
|
||||
name: labels-map
|
||||
description: É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).
|
||||
disable-model-invocation: 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'analyste étiquettera seul (`labeling/auto/`, D-102).
|
||||
|
||||
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 :
|
||||
|
||||
```markdown
|
||||
### <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
|
||||
|
||||
1. `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).
|
||||
2. 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).
|
||||
3. 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 observed` quand il faut qualifier ; pas de pseudo-probabilités.
|
||||
@@ -0,0 +1,36 @@
|
||||
"""Contrôle de la carte des étiquettes face à labeling/manual/*.jsonl (skill labels-map).
|
||||
|
||||
python3 .claude/skills/labels-map/controle.py
|
||||
Rend : clés citées inconnues, étiquettes revues absentes, où chaque étiquette est citée,
|
||||
les chiffres hors clés (à justifier un par un : nom de capteur, heure d'une image).
|
||||
"""
|
||||
import glob
|
||||
import json
|
||||
import os
|
||||
import re
|
||||
|
||||
CLE = r"[A-Z][A-Z_]{3,} \d\d\.\d\d \d\d:\d\d"
|
||||
|
||||
|
||||
def cle(station, debut):
|
||||
return f"{station} {debut[8:10]}.{debut[5:7]} {debut[11:16]}"
|
||||
|
||||
|
||||
revues = {}
|
||||
for chemin in sorted(glob.glob("labeling/manual/*.jsonl")):
|
||||
station = os.path.basename(chemin)[: -len(".jsonl")]
|
||||
for ligne in open(chemin, encoding="utf-8"):
|
||||
e = json.loads(ligne)
|
||||
revues[cle(station, e["debut"])] = "revue" in e
|
||||
|
||||
carte = open("labeling/carte-des-etiquettes.md", encoding="utf-8").read()
|
||||
citees = set(re.findall(CLE, carte))
|
||||
print("Clés inconnues :", sorted(citees - set(revues)) or "aucune")
|
||||
print("Revues absentes :", [k for k, r in revues.items() if r and k not in citees] or "aucune")
|
||||
sections = re.split(r"\n(?=#{2,4} )", carte)
|
||||
for k in sorted(revues):
|
||||
titres = [s.splitlines()[0].lstrip("# ")[:40] for s in sections if k in s]
|
||||
print(f" {k}{'' if revues[k] else ' (non revue)'} : {' | '.join(titres)}")
|
||||
reste = re.sub(CLE, "", carte)
|
||||
print("Chiffres hors clés :", sorted(set(re.findall(r"\S*\d\S*", reste))))
|
||||
print(len(carte.splitlines()), "lignes")
|
||||
Reference in new issue
Block a user