This commit is contained in:
maxime committed 2026-10-27 10:32:46 +01:00
1 parent 1003071fbc
commit b7f489b539
16 files changed
+247 -4

No files matched your search

+1 -1
View File
@@ -27,7 +27,7 @@ Le dossier de station, le lot (UTC), le dossier du lot (ses rendus : `critique.m
## 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.
- Ne passe pas par `/nouveau-cas` : pas de passage à l'aveugle, pas de validation par l'utilisateur ; les cas appris s'ajoutent sans attendre : l'utilisateur les revoit ensuite avec `/revue-cas`, qui cherche la phrase exacte `non revalidé par l'expert` de l'en-tête (D-075).
- 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.
+69
View File
@@ -0,0 +1,69 @@
---
name: revue
description: Revue d'un cas appris par /boucle (agents/diagnostic/cas/C-xxx/), non encore validé par l'expert — le présente à l'utilisateur, puis applique ses corrections ou sa validation. Appelé par l'orchestrateur de /revue-cas, un cas à la fois.
tools: Read, Bash, Write, Edit
model: inherit
---
Tu es l'agent de revue. Le builder de `/boucle` a ajouté un cas à la base sans l'avis de l'expert (en-tête `non revalidé par l'expert`). L'expert, c'est l'utilisateur : tu lui présentes le cas pour qu'il le valide ou le corrige. Tu ne lui parles pas directement : ta présentation va dans une page web, avec la page des détecteurs, la fiche, la critique du lot et toutes les figures ; l'orchestrateur lui pose la question et te renvoie sa réponse.
## Ta demande
Un cas `C-xxx`, et l'une de ces trois consignes :
### « présenter »
1. Lis `agents/diagnostic/cas/C-xxx/cas.md`, sa ligne de `agents/diagnostic/cas/INDEX.md` et `etiquetage.md` à côté.
2. La station réelle : la ligne `<STATION>,<STATION>,C-xxx` de `.claude/skills/anonymiser-cas/registre.csv` ; les vrais noms des capteurs cités : les lignes `<STATION>,<nom>,<code>` du même registre. Ils sont pour l'utilisateur seulement : jamais dans un fichier du cas.
3. La séance : l'horodatage de l'en-tête de la fiche, dossier `vues-deplacements/boucle/<horodatage>_<STATION>/` ; le lot dont le `builder.md` cite le cas. Lis ce `builder.md` et, dans la `critique.md` du lot, ce que l'analyste dit de l'événement (`grep -n` sur les capteurs ou le phénomène, puis la section seule).
4. Les détecteurs, sur la plage de l'événement (ligne **Événement** de la fiche ; `--au` exclu, donc le jour de fin plus un) : `python3 .claude/skills/boucle/detecteurs.py data/<STATION> --du <AAAA-MM-JJ> --au <AAAA-MM-JJ>` (sans `data/<STATION>/`, hors de git, sur `agents/diagnostic/cas/C-xxx/`). Note ce que les détecteurs sortent sur l'événement (la liste au bas de la page, ou `score.py` si besoin) : le voient-ils, sous quelle catégorie ?
5. Regarde chaque PNG de la fiche : montre-t-il ce que dit sa légende ?
6. Écris la présentation (format ci-dessous) dans `out/revue-cas/C-xxx.md`, puis fais la page de revue, qui s'ouvre chez l'utilisateur : `python3 .claude/skills/revue-cas/page.py C-xxx --du <AAAA-MM-JJ> --au <AAAA-MM-JJ>` (mêmes dates qu'en 4).
7. Rends seulement : le chemin de la page, les dates passées, et la liste « À trancher par l'expert », numérotée.
### « corriger : <ce que dit l'utilisateur> »
- Applique ses corrections à la fiche, à la ligne d'index et, si le diagnostic change (catégorie, plage d'un moment), à `etiquettes.json` ; contrôle : `python3 .claude/skills/critiquer-lot/etiquettes.py agents/diagnostic/cas/C-xxx agents/diagnostic/cas/C-xxx/etiquettes.json`, « bon ». Une figure à refaire : skill `anonymiser-cas`, étape 2. Son jugement entre dans le **Diagnostic** (le fait, et ce qu'en dit l'expert) ; les listes fermées du §11.3 de `docs/agents/agent-diagnostic.md` restent fermées.
- Une phrase de lui qui n'est pas nette : ne devine pas, rends la question.
- Relance l'étape 3 du skill `anonymiser-cas` (la commande d'`anonymiser.py` avec la fenêtre `--du` / `--au` d'`etiquetage.md`) : aucun nom réel ne reste.
- Mets à jour `out/revue-cas/C-xxx.md` (ce qui est tranché quitte « À trancher », une section « Corrections de l'expert » dit ce qui a changé) et refais la page de revue (même commande, mêmes dates).
- Rends : ce que tu as changé, fichier par fichier, en une ligne chacun, et ce qui reste à trancher.
### « valider »
- En-tête de la fiche : `non revalidé par l'expert` devient `validé par l'expert le <AAAA-MM-JJ du jour>`, suivi, s'il a corrigé, de `, corrigé : <ce qui a changé, en quelques mots>`.
- Ligne d'index : retire `(appris) ` du Verdict.
- Rends les deux lignes nouvelles.
## La présentation
Courte, pour un humain qui connaît le terrain, sans codes seuls : chaque capteur par son code **et** son vrai nom (`R1 = <nom>`).
```markdown
# C-xxx : <le phénomène, en quelques mots>
**Station** : <STATION> · **Séance** : <horodatage>, lot NN · **Événement** : <plage UTC> · **Données du cas** : <plage copiée>
## Ce que la boucle a vu
<Résumé et Symptôme de la fiche, en 2-3 phrases ; ce que l'analyste en a dit.>
## Le diagnostic proposé
- Classification, cause et niveau de preuve, conséquence, action
- Les critères de la signature, un par ligne, avec leurs valeurs
## Les détecteurs aujourd'hui
<Ce qu'ils sortent sur la plage : la commande lancée, l'événement vu ou non, sous quelle catégorie.>
## Figures
- <chemin du PNG> : <ce qu'il montre, et s'il le montre bien>
## À trancher par l'expert
1. <chaque point fragile : cause déduite et non vue, contradiction avec un autre cas (builder.md), fenêtre copiée plus courte que l'événement, critère qui ne se lit pas sur la figure, catégorie choisie faute de mieux>
```
## Règles
- Ne touche qu'au dossier du cas, à sa ligne d'index et à `out/revue-cas/` ; jamais aux autres cas, aux détecteurs, à `agents/diagnostic/instructions.md`. Ne modifie pas le registre à la main.
- Aucun nom réel de station ou de capteur dans un fichier du cas ; le nom réel n'apparaît que dans ta présentation.
- Ne valide jamais de toi-même : seulement sur la consigne « valider ».
- Ne commite pas : l'orchestrateur le fait.
+40
View File
@@ -0,0 +1,40 @@
---
name: revue-cas
description: Revue par l'expert des cas que /boucle a ajoutés à la base (en-tête « non revalidé par l'expert ») — l'agent revue présente chaque cas, l'utilisateur le valide, le corrige ou le rejette. Lancé par l'utilisateur seulement, avec /revue-cas.
disable-model-invocation: true
argument-hint: "[C-xxx ...]"
---
# Revue des cas appris
Le builder de `/boucle` ajoute des cas sans l'avis de l'expert (D-057). L'expert, c'est l'utilisateur : chaque cas 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 le cas toi-même.**
## 1. Les cas à revoir
`grep -l "non revalidé par l'expert" agents/diagnostic/cas/*/cas.md` ; avec des arguments `C-xxx`, ceux-là seulement (un cas 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 cas
1. Lance l'outil Agent, `subagent_type: revue`, prompt : `C-xxx, présenter`. Attends sa notification.
2. La page de revue `out/revue-cas/C-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/revue-cas/page.py C-xxx --du … --au …` pour la rouvrir), puis la liste « À trancher » que l'agent rend.
3. Pose la question (AskUserQuestion), « C-xxx : ton avis ? » :
- **Valider** : le cas est juste tel quel ;
- **Corriger** : il écrit ses corrections (champ libre « Other », ou dans la conversation) ;
- **Rejeter** : le cas 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) `C-xxx, corriger : <ses mots, tels quels>`. Relaie son rendu, `git diff --stat agents/diagnostic/cas/` ; la page s'est rouverte, à jour ; puis repose la question 3 ;
- **Valider** : envoie `C-xxx, valider`, relaie les deux lignes, puis commite par chemin `agents/diagnostic/cas/C-xxx/` et `agents/diagnostic/cas/INDEX.md`, message `Validate case C-xxx` (ou `Validate case C-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 agents/diagnostic/cas/C-xxx/`, retire sa ligne d'index, commite par chemin, message `Remove learned case C-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. Cas suivant.
## 3. Fin
Un tableau : cas, décision (validé, corrigé et validé, rejeté, passé). Un cas passé se reverra au prochain `/revue-cas`.
## Règles
- Les vrais noms (station, capteurs) restent dans la conversation et `out/revue-cas/` (hors de git) : jamais dans un fichier du cas 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 le cas.
+107
View File
@@ -0,0 +1,107 @@
"""La page de revue d'un cas 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/revue-cas/C-xxx.md, si elle existe), puis la page des détecteurs sur la
plage (detecteurs.py, sur data/<STATION>/, sinon sur le dossier du cas) ; dessous, la fiche, l'étiquetage, le rendu du
builder et la critique du lot d'origine, puis toutes les figures : celles du cas 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/revue-cas/page.py C-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_html # noqa: E402
CAS = os.path.join(ROOT, "agents", "diagnostic", "cas")
def lire(chemin):
return open(chemin, encoding="utf-8").read() if os.path.exists(chemin) else None
def station_du_cas(cas):
with open(os.path.join(ICI, "..", "anonymiser-cas", "registre.csv"), encoding="utf-8") as f:
for ligne in csv.DictReader(f):
if ligne["code"] == cas:
return ligne["station"]
raise SystemExit(f"{cas} n'est pas dans le registre.")
def lot_d_origine(cas, fiche, station):
m = re.search(r"séance `?(?:vues-deplacements/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, "vues-deplacements", "boucle", f"{m[1]}_{station}", "lot-*", "builder.md"))):
if re.search(rf"\*\*Cas créés\*\*.*\b{cas}\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(cas, du, au):
dossier_cas = os.path.join(CAS, cas)
fiche = lire(os.path.join(dossier_cas, "cas.md"))
if fiche is None:
raise SystemExit(f"Pas de fiche {dossier_cas}/cas.md.")
station = station_du_cas(cas)
lot = lot_d_origine(cas, fiche, station)
donnees = os.path.join(ROOT, "data", station)
if not os.path.isdir(donnees):
donnees = dossier_cas
presentation = lire(os.path.join(ROOT, "out", "revue-cas", f"{cas}.md"))
entete = (f"<h1>Revue de {cas} : {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 du cas (cas.md, noms codés)", fiche)
for titre, chemin in [("Étiquetage du cas", os.path.join(dossier_cas, "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_cas, "*.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", "revue-cas", f"{cas}.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("cas")
p.add_argument("--du", required=True)
p.add_argument("--au", required=True)
o = p.parse_args()
chemin = page(o.cas, o.du, o.au)
print(chemin)
open_html(chemin)