From 143bab6008edb2482661aea360cbc51326da59da Mon Sep 17 00:00:00 2001 From: maxime Date: Sat, 24 Oct 2026 15:12:44 +0200 Subject: [PATCH] Add the loop builder agent and a time window to the case anonymizer Co-Authored-By: Claude Opus 5.5 --- .claude/agents/builder.md | 46 +++++++++++++++++++ .claude/skills/anonymiser-cas/SKILL.md | 2 +- .claude/skills/anonymiser-cas/anonymiser.py | 51 +++++++++++++++++---- 3 files changed, 88 insertions(+), 11 deletions(-) create mode 100644 .claude/agents/builder.md diff --git a/.claude/agents/builder.md b/.claude/agents/builder.md new file mode 100644 index 0000000..61777ff --- /dev/null +++ b/.claude/agents/builder.md @@ -0,0 +1,46 @@ +--- +name: builder +description: Builder de la boucle automatique (/boucle) — ajoute à la base de cas (agents/diagnostic/cas/) les événements nouveaux signalés pendant un lot, marqués « appris ». Appelé par l'orchestrateur avec le dossier de station, le lot, le dossier du lot et celui de la séance. +tools: Read, Bash, Write, Edit +model: opus +--- + +Tu es le builder de la boucle automatique : tu construis la base de connaissances. Pendant un lot, l'analyste (et parfois l'upgrader ou le validateur) a noté des **nouveautés** : des événements que ni la carte des événements ni la base de cas ne décrivaient. Tu en fais des cas, de la même forme que ceux de la base. + +## Ta demande + +Le dossier de station, le lot (UTC), le dossier du lot (ses rendus : `critique.md`, `modification-K.md`, `validation-K.md`), le dossier de la séance, le chemin de ton rendu `builder.md`. + +## Ce que tu fais + +1. Lis la partie `## Nouveautés` de chaque rendu du lot, et ce que la critique en dit (parties 1 et 3, figures). +2. Lis `agents/diagnostic/cas/INDEX.md`. **Un cas par genre d'événement, pas par occurrence** : une nouveauté dont un cas a déjà la signature (même rôle des capteurs, même forme, même moment de la journée, même durée à peu près) ne donne rien. Ouvre la fiche d'un cas proche si tu hésites. +3. Pour chaque nouveauté vraiment nouvelle, un cas : + - **numéro** : le plus grand `C-xxx` de l'index, plus un ; dossier `agents/diagnostic/cas/C-xxx/` ; + - **données** : `python3 .claude/skills/anonymiser-cas/anonymiser.py agents/diagnostic/cas/C-xxx/ --du --au ` (instants `AAAA-MM-JJTHH:MMZ`) : seulement la fenêtre de l'événement et sa marge ; + - **fiche** `cas.md` : le modèle du §11.3 de `docs/agents/agent-diagnostic.md` (`grep -n '^### 11.3' docs/agents/agent-diagnostic.md`, puis lis cette section seule) ; prends exemple sur une fiche existante, par exemple `agents/diagnostic/cas/C-001/cas.md` ; + - **en tête de fiche**, juste sous le titre : `**Appris par la boucle** le , séance , non revalidé par l'expert` ; + - **figures et noms** : le skill `anonymiser-cas` (`.claude/skills/anonymiser-cas/SKILL.md`), étapes 2 à 4, avec la même fenêtre `--du` / `--au` à chaque relance ; + - **ligne d'index**, au format des autres ; son Verdict commence par `(appris)`. +4. La classification et la cause se rangent dans les listes fermées du §11.3 ; ce que les données ne tranchent pas se dit (« déduite », « inconnue »). + +## Règles + +- Ne modifie jamais un cas existant, ni `agents/diagnostic/instructions.md`, ni rien hors de tes nouveaux dossiers de cas, de l'index et de ton rendu (le registre `registre.csv` grandit tout seul par `anonymiser.py`). +- Ne passe pas par `/nouveau-cas` : pas de passage à l'aveugle, pas de validation par l'utilisateur ; les cas appris s'ajoutent sans attendre. +- Aucun nom réel de station ou de capteur ne reste dans un cas (l'étape 3 d'`anonymiser-cas` le vérifie) ; aucun identifiant (`SIM_CCID`, `ip`). +- Ne commite pas : l'orchestrateur le fait. + +## Ton rendu, `builder.md` + +```markdown +# Lot NN : builder + +**Cas créés** : C-006, C-007 | aucun + +- : créée (C-006) | déjà connue (C-00x) +``` + +## Ta réponse + +En 2 lignes : les cas créés, le chemin du rendu. diff --git a/.claude/skills/anonymiser-cas/SKILL.md b/.claude/skills/anonymiser-cas/SKILL.md index 0907ea1..7fc2257 100644 --- a/.claude/skills/anonymiser-cas/SKILL.md +++ b/.claude/skills/anonymiser-cas/SKILL.md @@ -8,7 +8,7 @@ argument-hint: "data// agents/diagnostic/cas/C-xxx/" 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). La station prend donc le numéro du cas (`C-001`), une référence devient `R1`, une cible `C1`, numérotées par station. Le cas porte ses données, déjà codées (D-050). Le registre `registre.csv`, à côté de ce fichier, garde les codes des capteurs d'un cas à l'autre et la station de chaque cas. -1. **Données** : `python3 .claude/skills/anonymiser-cas/anonymiser.py data// agents/diagnostic/cas/C-xxx/` copie `displacement/` et `images/` dans le dossier du cas, noms codés dans les CSV et les noms de fichiers, et imprime `NOM → CODE`. Un capteur inconnu reçoit le code suivant et entre dans le registre. +1. **Données** : `python3 .claude/skills/anonymiser-cas/anonymiser.py data// agents/diagnostic/cas/C-xxx/` copie `displacement/` et `images/` dans le dossier du cas, noms codés dans les CSV et les noms de fichiers, et imprime `NOM → CODE`. Un capteur inconnu reçoit le code suivant et entre dans le registre. Avec `--du T --au T` (`2026-10-07T12:00Z`), seules les mesures et les images de [du, au) sont copiées : pour un cas pris dans un long export (le builder de `/boucle`), la fenêtre de l'événement et sa marge, pas des centaines d'images ; repasse la même fenêtre aux étapes suivantes. 2. **Figures** : fais chaque figure du cas avec sa commande (`graphique.py`, `vignettes.py`) sur `agents/diagnostic/cas/C-xxx/`, avec `--sortie agents/diagnostic/cas/C-xxx/` : titres, légendes et noms de fichiers sont codés d'emblée. Dans la fiche, cite le fichier qu'elle imprime. 3. **Textes** : une fois la fiche et la ligne d'index écrites, relance la commande de l'étape 1 : - dans les `.md` du cas et `cas/INDEX.md`, `data//` devient `agents/diagnostic/cas/C-xxx/` et chaque nom son code ; diff --git a/.claude/skills/anonymiser-cas/anonymiser.py b/.claude/skills/anonymiser-cas/anonymiser.py index 6fee9fc..78b6633 100644 --- a/.claude/skills/anonymiser-cas/anonymiser.py +++ b/.claude/skills/anonymiser-cas/anonymiser.py @@ -2,8 +2,10 @@ des codes stables (D-049, D-050). Usage : - python3 .claude/skills/anonymiser-cas/anonymiser.py data// agents/diagnostic/cas/C-xxx/ + python3 .claude/skills/anonymiser-cas/anonymiser.py data// agents/diagnostic/cas/C-xxx/ [--du T] [--au T] copie displacement/ et images/ de la station dans le cas, noms codés dans les CSV et les noms de fichiers ; + avec --du / --au (2026-10-07T12:00Z), seulement les lignes et les images de [du, au) : un cas n'a pas besoin + des centaines d'images d'un long export (cas appris par la boucle, D-057) ; dans les .md du cas et cas/INDEX.md, data// devient le dossier du cas et chaque nom son code ; échoue s'il reste un nom réel python3 .claude/skills/anonymiser-cas/anonymiser.py --test @@ -23,7 +25,7 @@ REGISTRE = os.path.join(ICI, "registre.csv") INDEX = os.path.join(RACINE, "agents", "diagnostic", "cas", "INDEX.md") DONNEES = ("displacement", "images") # ce que lisent les outils de l'agent ; le reste de data// ne suit pas sys.path.insert(0, os.path.join(RACINE, "agents", "diagnostic", "outils")) -from donnees import charger, est_reference, trouver # noqa: E402 +from donnees import charger, est_reference, heure_image, instant, trouver # noqa: E402 def codes(dossier, cas_id): @@ -85,7 +87,25 @@ def ecrire(p, texte): f.write(texte) -def anonymiser(dossier, cas): +def dans(t, du, au): + return (du is None or t >= du) and (au is None or t < au) + + +def filtrer_csv(texte, du, au): + """L'en-tête et les lignes dont le premier champ (l'heure, UTC) tombe dans [du, au), gardées à l'identique.""" + if du is None and au is None: + return texte + lignes = texte.splitlines(keepends=True) + return "".join(lignes[:1] + [l for l in lignes[1:] if l.strip() and dans(instant(l.split(",", 1)[0]), du, au)]) + + +def garder_image(nom, du, au): + """Vrai si l'heure du nom (D-045) tombe dans [du, au) ; une image sans heure lisible est gardée.""" + t = heure_image(nom) + return t is None or dans(t, du, au) + + +def anonymiser(dossier, cas, du=None, au=None): cas_id = os.path.basename(os.path.normpath(cas)) if not re.fullmatch(r"C-\d{3}", cas_id): sys.exit(f"Le dossier du cas doit s'appeler C-xxx : {cas}") @@ -101,8 +121,8 @@ def anonymiser(dossier, cas): dst = os.path.join(cas, remplacer(os.path.relpath(src, dossier), table, station)) os.makedirs(os.path.dirname(dst), exist_ok=True) if f.endswith(".csv"): - ecrire(dst, remplacer(lire(src), table, station)) - else: + ecrire(dst, remplacer(filtrer_csv(lire(src), du, au), table, station)) + elif garder_image(f, du, au): shutil.copy2(src, dst) def textes(): @@ -133,14 +153,25 @@ def _test(): assert f("displacement/Carrière X (B)_20260728_to_20260731_1hour.csv") == "displacement/C-001_20260728_to_20260731_1hour.csv" t.update({"R1": "R1", "PA1_2": "R4"}) # un nom en forme de code le garde : un second passage ne change rien assert f(f("R1,PA1_2")) == "R1,R4" + du, au = instant("2026-10-07T12:00Z"), instant("2026-10-08T00:00Z") + txt = "time_utc,x\n2026-10-07 11:59:00+00:00,1\n2026-10-07 12:00:09+00:00,2\n2026-10-08 00:00:00+00:00,3\n" + assert filtrer_csv(txt, du, au) == "time_utc,x\n2026-10-07 12:00:09+00:00,2\n" + assert filtrer_csv(txt, None, None) == txt + assert filtrer_csv("timestamp,a\r\n2026-10-07 13:00:00,1\r\n", du, au) == "timestamp,a\r\n2026-10-07 13:00:00,1\r\n" + assert garder_image("20261007T1200Z_1.jpg", du, au) and not garder_image("20261008T0000Z_2.jpg", du, au) + assert garder_image("sans_heure.jpg", du, au) print("ok") if __name__ == "__main__": - a = sys.argv[1:] - if a == ["--test"]: + if sys.argv[1:] == ["--test"]: _test() - elif len(a) == 2: - anonymiser(*a) else: - sys.exit(__doc__) + import argparse + p = argparse.ArgumentParser(usage=__doc__) + p.add_argument("dossier") + p.add_argument("cas") + p.add_argument("--du", type=instant, help="premier instant gardé, UTC") + p.add_argument("--au", type=instant, help="premier instant exclu, UTC") + a = p.parse_args() + anonymiser(a.dossier, a.cas, a.du, a.au)