Add the loop builder agent and a time window to the case anonymizer
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
c1152f2076
commit
143bab6008
3 files changed
+88
-11
No files matched your search
@@ -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 <dossier de station> agents/diagnostic/cas/C-xxx/ --du <début − 6 h> --au <fin + 6 h>` (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 <AAAA-MM-JJ>, séance <dossier de la 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
|
||||||
|
|
||||||
|
- <nouveauté> : créée (C-006) | déjà connue (C-00x)
|
||||||
|
```
|
||||||
|
|
||||||
|
## Ta réponse
|
||||||
|
|
||||||
|
En 2 lignes : les cas créés, le chemin du rendu.
|
||||||
@@ -8,7 +8,7 @@ argument-hint: "data/<STATION>/ 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.
|
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/<STATION>/ 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/<STATION>/ 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.
|
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 :
|
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/<STATION>/` devient `agents/diagnostic/cas/C-xxx/` et chaque nom son code ;
|
- dans les `.md` du cas et `cas/INDEX.md`, `data/<STATION>/` devient `agents/diagnostic/cas/C-xxx/` et chaque nom son code ;
|
||||||
|
|||||||
@@ -2,8 +2,10 @@
|
|||||||
des codes stables (D-049, D-050).
|
des codes stables (D-049, D-050).
|
||||||
|
|
||||||
Usage :
|
Usage :
|
||||||
python3 .claude/skills/anonymiser-cas/anonymiser.py data/<STATION>/ agents/diagnostic/cas/C-xxx/
|
python3 .claude/skills/anonymiser-cas/anonymiser.py data/<STATION>/ 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 ;
|
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/<STATION>/ devient le dossier du cas et chaque nom son code ;
|
dans les .md du cas et cas/INDEX.md, data/<STATION>/ devient le dossier du cas et chaque nom son code ;
|
||||||
échoue s'il reste un nom réel
|
échoue s'il reste un nom réel
|
||||||
python3 .claude/skills/anonymiser-cas/anonymiser.py --test
|
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")
|
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/<STATION>/ ne suit pas
|
DONNEES = ("displacement", "images") # ce que lisent les outils de l'agent ; le reste de data/<STATION>/ ne suit pas
|
||||||
sys.path.insert(0, os.path.join(RACINE, "agents", "diagnostic", "outils"))
|
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):
|
def codes(dossier, cas_id):
|
||||||
@@ -85,7 +87,25 @@ def ecrire(p, texte):
|
|||||||
f.write(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))
|
cas_id = os.path.basename(os.path.normpath(cas))
|
||||||
if not re.fullmatch(r"C-\d{3}", cas_id):
|
if not re.fullmatch(r"C-\d{3}", cas_id):
|
||||||
sys.exit(f"Le dossier du cas doit s'appeler C-xxx : {cas}")
|
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))
|
dst = os.path.join(cas, remplacer(os.path.relpath(src, dossier), table, station))
|
||||||
os.makedirs(os.path.dirname(dst), exist_ok=True)
|
os.makedirs(os.path.dirname(dst), exist_ok=True)
|
||||||
if f.endswith(".csv"):
|
if f.endswith(".csv"):
|
||||||
ecrire(dst, remplacer(lire(src), table, station))
|
ecrire(dst, remplacer(filtrer_csv(lire(src), du, au), table, station))
|
||||||
else:
|
elif garder_image(f, du, au):
|
||||||
shutil.copy2(src, dst)
|
shutil.copy2(src, dst)
|
||||||
|
|
||||||
def textes():
|
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"
|
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
|
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"
|
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")
|
print("ok")
|
||||||
|
|
||||||
|
|
||||||
if __name__ == "__main__":
|
if __name__ == "__main__":
|
||||||
a = sys.argv[1:]
|
if sys.argv[1:] == ["--test"]:
|
||||||
if a == ["--test"]:
|
|
||||||
_test()
|
_test()
|
||||||
elif len(a) == 2:
|
|
||||||
anonymiser(*a)
|
|
||||||
else:
|
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)
|
||||||
Reference in new issue
Block a user