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:
1 parent
4d99585474
commit
446fde3192
1206 files changed
+2172
-2129
No files matched your search
@@ -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.
|
||||
@@ -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)
|
||||
Reference in new issue
Block a user