Code station and sensor names in the diagnostic case base (D-049)

Add the anonymiser-cas skill: a growing registry gives stable codes
(S01, R1, C1), a stdlib script rewrites a case and renames its files,
and graphique.py / vignettes.py take --alias to plot with codes.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-10-14 17:45:40 +02:00
1 parent 3478d77f1d
commit a684349501
15 files changed
+203 -30

No files matched your search

+26
View File
@@ -0,0 +1,26 @@
---
name: anonymiser-cas
description: À utiliser quand une fiche ou une figure de la base de cas de l'agent de diagnostic (agents/diagnostic/cas/) porte un nom réel de station, de référence ou de cible — à l'étape 5 de /nouveau-cas, avant de montrer la fiche, ou sur un cas déjà entré.
argument-hint: "data/<STATION>/ agents/diagnostic/cas/<dossier du cas>/"
---
# Anonymiser un cas
L'agent lit la base de cas. Un nom de site ou de capteur l'ancrerait sur le nom plutôt que sur la signature (D-049). Tous les noms deviennent donc des codes stables : `S01` pour une station, `R1` pour une référence, `C1` pour une cible, numérotés par station. Le registre `registre.csv`, à côté de ce fichier, garde les correspondances d'un cas à l'autre.
1. **Codes** : `python3 .claude/skills/anonymiser-cas/anonymiser.py data/<STATION>/ --alias` imprime `NOM=CODE,...`. Un nom inconnu reçoit le code suivant et entre dans le registre.
2. **Figures** : le script ne peut pas réécrire le texte d'un PNG. Fais chaque figure du cas avec sa commande (`graphique.py`, `vignettes.py`), `--sortie <dossier du cas>` et `--alias "<sortie de l'étape 1>"`. Dans la fiche, cite le fichier qu'elle imprime, déjà codé. Supprime les PNG aux noms réels.
3. **Textes et noms de fichiers** : `python3 .claude/skills/anonymiser-cas/anonymiser.py data/<STATION>/ agents/diagnostic/cas/<dossier du cas>/` :
- réécrit les `.md` du cas et `cas/INDEX.md` ;
- renomme les fichiers et le dossier (`C-xxx_S01_<date>`) ;
- s'arrête en listant tout nom réel qui reste (souvent une casse différente) : corrige à la main, puis relance.
4. **Regarde chaque PNG** : des codes dans le titre, la légende et les vignettes, aucun nom réel.
## Règles
- Le registre ne fait que grandir : ne renumérote rien et ne supprime aucune ligne. Commite-le avec le cas.
- Le registre ne va jamais à l'agent : ni dans ses sources, ni dans un prompt, ni dans une fiche.
- Les commandes de la fiche portent les codes (`data/S01/`, `--capteurs R3,R2`). Pour les rejouer, prends les noms dans le registre.
- Un chemin vers `rapports/`, qui garde les vrais noms, devient codé. Son préfixe horodaté suffit pour le retrouver : `ls agents/diagnostic/rapports/<AAAA-MM-JJTHHMMZ>_*`.
- Les images montrent le site lui-même : ce qu'elles laissent voir ne s'anonymise pas.
- Vérifier le script après l'avoir modifié : `python3 .claude/skills/anonymiser-cas/anonymiser.py --test`.
+112
View File
@@ -0,0 +1,112 @@
"""Anonymise un cas de la base de l'agent de diagnostic : la station et ses capteurs deviennent des codes stables.
Usage :
python3 .claude/skills/anonymiser-cas/anonymiser.py data/<STATION>/ agents/diagnostic/cas/<dossier du cas>/
réécrit les .md du cas et cas/INDEX.md, renomme fichiers et dossier ; échoue s'il reste un nom réel
python3 .claude/skills/anonymiser-cas/anonymiser.py data/<STATION>/ --alias
imprime NOM=CODE,... pour l'option --alias de graphique.py et vignettes.py
python3 .claude/skills/anonymiser-cas/anonymiser.py --test
Codes : S01, S02... pour les stations ; R1, R2... pour les références et C1, C2... pour les cibles, par station.
Le registre (registre.csv, à côté) ne fait que grandir : un nom garde son code d'un cas à l'autre.
"""
import csv
import os
import re
import sys
ICI = os.path.dirname(os.path.abspath(__file__))
RACINE = os.path.normpath(os.path.join(ICI, "..", "..", ".."))
REGISTRE = os.path.join(ICI, "registre.csv")
INDEX = os.path.join(RACINE, "agents", "diagnostic", "cas", "INDEX.md")
sys.path.insert(0, os.path.join(RACINE, "agents", "diagnostic", "outils"))
from donnees import charger, est_reference # noqa: E402
def codes(dossier):
"""{nom: code} de la station et de ses capteurs ; un nom inconnu reçoit le code suivant, ajouté au registre."""
station = os.path.basename(os.path.normpath(dossier))
par = charger(dossier)
if not par:
sys.exit(f"Aucun export « advanced » dans {dossier}.")
lignes = list(csv.DictReader(open(REGISTRE, newline=""))) if os.path.exists(REGISTRE) else []
connus = {(l["station"], l["nom"]): l["code"] for l in lignes}
nouveaux = []
if (station, station) not in connus:
n = max((int(c[1:]) for (s, nom), c in connus.items() if s == nom), default=0)
nouveaux.append((station, station, f"S{n + 1:02d}"))
for prefixe, reference in (("R", True), ("C", False)):
n = max((int(c[1:]) for (s, nom), c in connus.items() if s == station != nom and c[0] == prefixe), default=0)
for nom in sorted(x for x in par if est_reference(par[x]) == reference and (station, x) not in connus):
n += 1
nouveaux.append((station, nom, f"{prefixe}{n}"))
if nouveaux:
with open(REGISTRE, "a", newline="") as f:
w = csv.writer(f)
if not lignes:
w.writerow(("station", "nom", "code"))
w.writerows(nouveaux)
connus.update({(s, nom): c for s, nom, c in nouveaux})
return station, {nom: c for (s, nom), c in connus.items() if s == station}
def motif(table, station, casse=False):
"""Les noms, du plus long au plus court, bornés par un caractère non alphanumérique (« _ » compris : un nom
collé dans un nom de fichier est trouvé, mais BJ_C ne l'est pas dans PBJ_C). La station accepte espace ou « _ »
et toute casse (PS_DES_COUDRES, « PS des Coudres »)."""
parties = []
for nom in sorted(table, key=len, reverse=True):
p = re.escape(nom)
parties.append(f"(?i:{p.replace('_', '[ _]')})" if nom == station else p)
return re.compile(("(?i)" if casse else "") + r"(?<![A-Za-z0-9])(" + "|".join(parties) + r")(?![A-Za-z0-9])")
def remplacer(texte, table, station):
return motif(table, station).sub(lambda m: table.get(m.group(1), table[station]), texte)
def anonymiser(dossier, cas):
station, table = codes(dossier)
textes = [os.path.join(r, f) for r, _, fs in os.walk(cas) for f in fs if f.endswith(".md")] + [INDEX]
for p in textes:
avant = open(p).read()
apres = remplacer(avant, table, station)
if apres != avant:
open(p, "w").write(apres)
for r, dossiers, fichiers in os.walk(cas, topdown=False):
for f in fichiers + dossiers:
if remplacer(f, table, station) != f:
os.rename(os.path.join(r, f), os.path.join(r, remplacer(f, table, station)))
parent, nom = os.path.split(os.path.normpath(cas))
cas = os.path.join(parent, remplacer(nom, table, station))
os.rename(os.path.join(parent, nom), cas)
reste = motif(table, station, casse=True)
textes = [os.path.join(r, f) for r, _, fs in os.walk(cas) for f in fs if f.endswith(".md")] + [INDEX]
residus = [f"{p} : {m.group(1)}" for p in textes for m in reste.finditer(open(p).read())]
residus += [os.path.join(r, f) for r, ds, fs in os.walk(cas) for f in fs + ds if reste.search(f)]
if residus:
sys.exit("Noms réels restants (casse différente ?) :\n " + "\n ".join(residus))
print(cas)
print(", ".join(f"{n} → {c}" for n, c in sorted(table.items(), key=lambda x: x[1])))
def _test():
t = {"PS_DES_COUDRES": "S01", "BJ_C": "C1", "PBJ_C": "C7", "REF_G": "R3"}
f = lambda s: remplacer(s, t, "PS_DES_COUDRES") # noqa: E731
assert f("PBJ_C et BJ_C") == "C7 et C1"
assert f("PS_DES_COUDRES_error_value_REF_G-BJ_C.png") == "S01_error_value_R3-C1.png"
assert f("PS des Coudres, REF_GX, data/PS_DES_COUDRES/") == "S01, REF_GX, data/S01/"
print("ok")
if __name__ == "__main__":
a = sys.argv[1:]
if a == ["--test"]:
_test()
elif len(a) == 2 and a[1] == "--alias":
_, table = codes(a[0])
print(",".join(f"{n}={c}" for n, c in sorted(table.items())))
elif len(a) == 2:
anonymiser(*a)
else:
sys.exit(__doc__)
@@ -0,0 +1,17 @@
station,nom,code
PS_DES_COUDRES,PS_DES_COUDRES,S01
PS_DES_COUDRES,REF_CT,R1
PS_DES_COUDRES,REF_D,R2
PS_DES_COUDRES,REF_G,R3
PS_DES_COUDRES,BJ_C,C1
PS_DES_COUDRES,BJ_D,C2
PS_DES_COUDRES,BJ_G,C3
PS_DES_COUDRES,BL_C,C4
PS_DES_COUDRES,BL_D,C5
PS_DES_COUDRES,BL_G,C6
PS_DES_COUDRES,PBJ_C,C7
PS_DES_COUDRES,PBL_C,C8
PS_DES_COUDRES,PBL_D,C9
PS_DES_COUDRES,PM_C,C10
PS_DES_COUDRES,PM_D,C11
PS_DES_COUDRES,PM_G,C12
1 station nom code
2 PS_DES_COUDRES PS_DES_COUDRES S01
3 PS_DES_COUDRES REF_CT R1
4 PS_DES_COUDRES REF_D R2
5 PS_DES_COUDRES REF_G R3
6 PS_DES_COUDRES BJ_C C1
7 PS_DES_COUDRES BJ_D C2
8 PS_DES_COUDRES BJ_G C3
9 PS_DES_COUDRES BL_C C4
10 PS_DES_COUDRES BL_D C5
11 PS_DES_COUDRES BL_G C6
12 PS_DES_COUDRES PBJ_C C7
13 PS_DES_COUDRES PBL_C C8
14 PS_DES_COUDRES PBL_D C9
15 PS_DES_COUDRES PM_C C10
16 PS_DES_COUDRES PM_D C11
17 PS_DES_COUDRES PM_G C12
+4 -3
View File
@@ -44,18 +44,19 @@ Le sous-agent reçoit la branche et les derniers messages de commit (§7 de la s
- **Numéro** : le plus grand `C-xxx` de `agents/diagnostic/cas/INDEX.md`, plus un (C-001 si l'index est vide). Dossier : `agents/diagnostic/cas/C-xxx_<STATION>_<AAAA-MM-JJ du début>/`, `<STATION>` étant le nom du dossier de `data/`.
- **`cas.md`** suit le modèle du §11.3 de la spec (`grep -n '^### 11.3' docs/agents/agent-diagnostic.md`, puis lis cette section seule) :
- **Signature** et **Exclusions** : tirées des faits et des commandes du rapport à l'aveugle. Les critères sont observables, relatifs au niveau habituel du capteur (MAD), sans nom de capteur ni seuil absolu ; leurs commandes gardent les vrais noms, pour se rejouer. Chaque exclusion se vérifie avec les outils ;
- **Signature** et **Exclusions** : tirées des faits et des commandes du rapport à l'aveugle. Les critères sont observables, relatifs au niveau habituel du capteur (MAD), sans nom de capteur ni seuil absolu ; leurs commandes s'écrivent avec les vrais noms, pour se rejouer ; l'anonymisation les code ensuite. Chaque exclusion se vérifie avec les outils ;
- **Diagnostic de l'expert** : avec ses mots ; la cause est aussi rapportée à la liste fermée du rapport (buée ou eau, occlusion, turbulence, éclairage, inconnue) ;
- **Attendu de l'agent** : ce qu'il doit dire sur ces données sans ce cas dans l'index (le passage à l'aveugle), puis avec ;
- **Preuves** : copie les PNG du rapport à côté de `cas.md` et regarde chacun ;
- **Preuves** : refais les figures du rapport avec leurs commandes, dans le dossier du cas et avec `--alias` (skill `anonymiser-cas`, étape 2), puis regarde chacune ;
- **Test à l'aveugle** : le chemin du rapport et le tableau de 4.3.
- **Ligne d'index** : `| [C-xxx](C-xxx_<STATION>_<date>/cas.md) | <Station> · <fenêtre UTC> | <signature courte, observable> | <classification> | <cause de l'expert> | <conséquence, action> |`. Retire « *Base vide pour l'instant.* ».
- **Validation du rapport à l'aveugle** : verdict accepté ou corrigé (en quoi) ; diagnostic final, celui de l'expert ; `Devient un cas : oui (C-xxx)`.
- **Anonymise** avec le skill `anonymiser-cas` : station et capteurs deviennent des codes (`S01`, `R1`, `C1`), le dossier devient `C-xxx_<code>_<date>` (D-049).
- **Montre la fiche et la ligne d'index à l'utilisateur, et attends son accord** : c'est l'expert qui valide un cas, pas Claude.
## 6. Commit et test de correspondance
1. Commite par chemin `agents/diagnostic/cas/` et le rapport, avec le message `Add case C-xxx to the diagnostic case base` ; l'arbre est alors propre.
1. Commite par chemin `agents/diagnostic/cas/`, le registre `.claude/skills/anonymiser-cas/registre.csv` et le rapport, avec le message `Add case C-xxx to the diagnostic case base` ; l'arbre est alors propre.
2. Relance l'agent avec le même prompt (4.2), cette fois avec le cas dans l'index. Attendu : `C-xxx, complète` (ou partielle s'il manque une donnée), et le diagnostic de l'expert ; « aucune » conséquence seulement si la règle d'asymétrie le permet. Ce passage vérifie la mécanique de correspondance, pas le jugement : l'agent a lu la fiche.
3. Si le cas ne correspond pas, la signature est trop stricte ou trop vague : corrige la fiche et relance. Consigne le résultat dans « Test à l'aveugle » de la fiche, même s'il réussit du premier coup, puis commite par chemin la fiche et le second rapport (`Record the C-xxx match test`).