changes
This commit is contained in:
1 parent
1003071fbc
commit
b7f489b539
16 files changed
+247
-4
No files matched your search
@@ -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.
|
||||
|
||||
|
||||
@@ -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.
|
||||
@@ -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.
|
||||
@@ -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)
|
||||
Reference in new issue
Block a user