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.
|
||||
|
||||
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.
|
||||
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 ;
|
||||
|
||||
@@ -2,8 +2,10 @@
|
||||
des codes stables (D-049, D-050).
|
||||
|
||||
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 ;
|
||||
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 ;
|
||||
é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/<STATION>/ 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)
|
||||
Reference in new issue
Block a user