Events: read-event skill to consult the base (D-085), cases renamed events E-xxx (D-086)

- read-event: map and index first, then the card of close events only,
  then their data with the reading tools; never all cards at once.
  Diagnostic agent, critiquer-lot and builder point to it; the index
  header too. Signature length: about 250 characters, a guideline.
- "Cas" becomes "event": events/E-xxx/event.md, skills new-event,
  review-event, anonymize-event.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-10-29 07:25:29 +01:00
1 parent 4d99585474
commit 446fde3192
1206 files changed
+2172 -2129

No files matched your search

+40
View File
@@ -0,0 +1,40 @@
---
name: review-event
description: Revue par l'expert des events que /boucle a ajoutés à la base (en-tête « non revalidé par l'expert ») — l'agent revue présente chaque event, l'utilisateur le valide, le corrige ou le rejette. Lancé par l'utilisateur seulement, avec /review-event.
disable-model-invocation: true
argument-hint: "[E-xxx ...]"
---
# Revue des events appris
Le builder de `/boucle` ajoute des events sans l'avis de l'expert (D-057). L'expert, c'est l'utilisateur : chaque event qu'il n'a pas validé passe par cette revue. Tu es l'orchestrateur : l'agent `revue` présente et modifie, toi tu relaies, poses la question et commites. **Tu ne juges pas l'event toi-même.**
## 1. Les events à revoir
`grep -l "non revalidé par l'expert" events/*/event.md` ; avec des arguments `E-xxx`, ceux-là seulement (un event déjà validé : dis-le et passe). Aucun : dis-le et arrête-toi. Annonce la liste, puis prends-les un par un, du plus petit numéro au plus grand.
## 2. Pour chaque event
1. Lance l'outil Agent, `subagent_type: revue`, prompt : `E-xxx, présenter`. Attends sa notification.
2. La page de revue `out/review-event/E-xxx.html` s'est ouverte dans son navigateur : la présentation de l'agent, la page des détecteurs, la fiche, la critique du lot d'origine, toutes les figures. **Ne recopie pas la présentation dans la conversation** : dis en une ligne que la page est ouverte (avec son chemin, `python3 .claude/skills/review-event/page.py E-xxx --du … --au …` pour la rouvrir), puis la liste « À trancher » que l'agent rend.
3. Pose la question (AskUserQuestion), « E-xxx : ton avis ? » :
- **Valider** : l'event est juste tel quel ;
- **Corriger** : il écrit ses corrections (champ libre « Other », ou dans la conversation) ;
- **Rejeter** : l'event ne doit pas rester dans la base ;
- **Passer** : plus tard, rien ne change.
4. Selon sa réponse :
- **Corriger** : envoie à l'agent (SendMessage, son identifiant ; à défaut, un nouvel agent `revue` avec le même début de prompt) `E-xxx, corriger : <ses mots, tels quels>`. Relaie son rendu, `git diff --stat events/` ; la page s'est rouverte, à jour ; puis repose la question 3 ;
- **Valider** : envoie `E-xxx, valider`, relaie les deux lignes, puis commite par chemin `events/E-xxx/` et `events/INDEX.md`, message `Validate event E-xxx` (ou `Validate case E-xxx with the expert's corrections`) ;
- **Rejeter** : demande en une phrase s'il faut une trace (une ligne dans la critique du lot d'origine suffit), puis `git rm -r events/E-xxx/`, retire sa ligne d'index, commite par chemin, message `Remove learned case E-xxx rejected by the expert`. Le registre garde ses lignes (il ne fait que grandir) ; le numéro n'est pas réutilisé ;
- **Passer** : rien.
5. Event suivant.
## 3. Fin
Un tableau : event, décision (validé, corrigé et validé, rejeté, passé). Un event passé se reverra au prochain `/review-event`.
## Règles
- Les vrais noms (station, capteurs) restent dans la conversation et `out/review-event/` (hors de git) : jamais dans un fichier de l'event ni un message de commit.
- Une correction qui touche une règle générale (les instructions de l'agent de diagnostic, un détecteur, le builder) n'est pas faite ici : note-la pour l'utilisateur dans le tableau de fin.
- Les autres fichiers modifiés de l'arbre ne se commitent pas avec l'event.
+108
View File
@@ -0,0 +1,108 @@
"""La page de revue d'un event appris : tout ce qu'il faut à l'expert pour trancher, sur une seule page (D-075).
En tête, la présentation de l'agent revue (out/review-event/E-xxx.md, si elle existe), puis la page des détecteurs sur la
plage (detecteurs.py, sur data/<STATION>/, sinon sur le dossier de l'event) ; dessous, la fiche, l'étiquetage, le rendu du
builder et la critique du lot d'origine, puis toutes les figures : celles de l'event et celles du lot de la séance.
Les vrais noms y figurent (registre) : la page reste dans out/, hors de git.
Usage : python3 .claude/skills/review-event/page.py E-xxx --du AAAA-MM-JJ --au AAAA-MM-JJ (--au exclu ; page ouverte)
"""
import argparse
import base64
import csv
import glob
import html
import json
import os
import re
import sys
ICI = os.path.dirname(os.path.abspath(__file__))
sys.path.insert(0, os.path.join(ICI, "..", "boucle"))
import detecteurs # noqa: E402
from comparaison import ROOT, open_served # noqa: E402
EVENTS = os.path.join(ROOT, "events")
def lire(chemin):
return open(chemin, encoding="utf-8").read() if os.path.exists(chemin) else None
def station_de_l_event(event):
with open(os.path.join(ICI, "..", "anonymize-event", "registre.csv"), encoding="utf-8") as f:
for ligne in csv.DictReader(f):
if ligne["code"] == event:
return ligne["station"]
raise SystemExit(f"{event} n'est pas dans le registre.")
def lot_d_origine(event, fiche, station):
m = re.search(r"séance `?(?:boucle/)?(\d{4}-\d\d-\d\dT\d{4}Z)", fiche)
if not m:
return None
for builder in sorted(glob.glob(os.path.join(ROOT, "boucle", f"{m[1]}_{station}", "lot-*", "builder.md"))):
# avant D-086, les builders écrivaient « Cas créés » et C-xxx
if re.search(rf"\*\*(?:Cas|Events) créés\*\*.*\b[CE]-{event[2:]}\b", lire(builder)):
return os.path.dirname(builder)
return None
def bloc(titre, texte, ouvert=True):
# les figures citées dans les .md sont dans la galerie, en bas : on retire les liens d'image, cassés depuis out/
texte = re.sub(r"!\[[^\]]*\]\([^)]*\)", "", texte)
source = json.dumps(texte).replace("</", "<\\/")
return (f"<details{' open' if ouvert else ''}><summary><h2 style='display:inline'>{html.escape(titre)}</h2></summary>"
f"<div class='md' data-md='{html.escape(source, quote=True)}'></div></details>")
def figure(chemin):
donnees = base64.b64encode(open(chemin, "rb").read()).decode()
nom = os.path.relpath(chemin, ROOT)
return f"<figure><img src='data:image/png;base64,{donnees}' alt='{html.escape(nom)}'><figcaption>{html.escape(nom)}</figcaption></figure>"
def page(event, du, au):
dossier_event = os.path.join(EVENTS, event)
fiche = lire(os.path.join(dossier_event, "event.md"))
if fiche is None:
raise SystemExit(f"Pas de fiche {dossier_event}/event.md.")
station = station_de_l_event(event)
lot = lot_d_origine(event, fiche, station)
donnees = os.path.join(ROOT, "data", station)
if not os.path.isdir(donnees):
donnees = dossier_event
presentation = lire(os.path.join(ROOT, "out", "review-event", f"{event}.md"))
entete = (f"<h1>Revue de {event} : {html.escape(station)}</h1>"
f"<p>Lot d'origine : {html.escape(os.path.relpath(lot, ROOT)) if lot else 'introuvable'} · "
f"détecteurs sur {html.escape(os.path.relpath(donnees, ROOT))}</p>")
entete += bloc("Présentation de l'agent revue", presentation) if presentation else "<p>Pas encore de présentation de l'agent revue.</p>"
annexe = bloc("Fiche de l'event (event.md, noms codés)", fiche)
for titre, chemin in [("Étiquetage de l'event", os.path.join(dossier_event, "etiquetage.md")),
("Rendu du builder", lot and os.path.join(lot, "builder.md")),
("Critique de l'analyste, lot d'origine", lot and os.path.join(lot, "critique.md"))]:
texte = chemin and lire(chemin)
if texte:
annexe += bloc(titre, texte, ouvert=False)
pngs = sorted(glob.glob(os.path.join(dossier_event, "*.png"))) + (sorted(glob.glob(os.path.join(lot, "*.png"))) if lot else [])
annexe += f"<h2>Figures ({len(pngs)})</h2>" + "".join(figure(p) for p in pngs)
annexe += """<style>details{margin:12px 0} summary{cursor:pointer} .md{max-width:70em} .md table{margin:8px 0}
figure{margin:16px 0} figure img{max-width:100%;border:1px solid #e6e6e2} figcaption{color:#5f5e5a;font-size:13px}</style>
<script src="https://cdn.jsdelivr.net/npm/marked@12.0.2/marked.min.js"></script>
<script>document.querySelectorAll('.md').forEach(d => d.innerHTML = marked.parse(JSON.parse(d.dataset.md)));</script>"""
chemin = os.path.join(ROOT, "out", "review-event", f"{event}.html")
os.makedirs(os.path.dirname(chemin), exist_ok=True)
return detecteurs.page(donnees, du, au, entete=entete, annexe=annexe, chemin=chemin)
if __name__ == "__main__":
p = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter)
p.add_argument("event")
p.add_argument("--du", required=True)
p.add_argument("--au", required=True)
o = p.parse_args()
chemin = page(o.event, o.du, o.au)
print(chemin)
open_served(chemin)