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:
1 parent
3478d77f1d
commit
a684349501
15 files changed
+203
-30
No files matched your search
@@ -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`.
|
||||
@@ -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
|
||||
|
@@ -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`).
|
||||
|
||||
|
||||
Reference in new issue
Block a user