Add the /nouveau-cas skill to add expert-validated cases to the diagnostic case base
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
e26871d148
commit
2aa15a5df0
4 files changed
+79
-19
No files matched your search
@@ -0,0 +1,62 @@
|
||||
---
|
||||
name: nouveau-cas
|
||||
description: Ajouter un incident validé par l'expert à la base de cas de l'agent de diagnostic (D-048) — nouvelles données de déplacements et images, avec le diagnostic de l'expert. Lancé seulement par l'utilisateur, avec /nouveau-cas.
|
||||
disable-model-invocation: true
|
||||
argument-hint: "[fichiers ou dossier des données] [station] [fenêtre UTC]"
|
||||
---
|
||||
|
||||
# Ajouter un cas à la base de l'agent de diagnostic
|
||||
|
||||
Un cas, c'est un incident (station, fenêtre) et le diagnostic de l'expert, rangés dans `agents/diagnostic/cas/` (spec : §11 de `docs/agents/agent-diagnostic.md`). Avant d'écrire la fiche, l'agent passe à l'aveugle sur l'incident : c'est le test de régression du cas. Lancer ce skill est la demande explicite d'ajout ; des données reçues ou un rapport validé n'ajoutent jamais un cas d'eux-mêmes.
|
||||
|
||||
## 1. Réunir la demande, en un seul message
|
||||
|
||||
Demande ce qui manque, en une fois :
|
||||
- les fichiers : l'export « advanced » (CSV avec `sensor_name`) et, s'il y en a, les images, avec le fuseau horaire de leur heure. Sous WSL, les fichiers de Windows sont dans `/mnt/c/Users/<nom>/Downloads/` ; une archive s'extrait dans un dossier vide du scratchpad, jamais dans le dépôt ;
|
||||
- la station et la fenêtre de l'incident, en UTC ;
|
||||
- le diagnostic de l'expert : ce que voit le client (symptôme) ; classification ; cause ; niveau de preuve (a-t-il vu la cause, ou l'infère-t-il ?) ; conséquence pour l'ouvrage (aucune | mouvement réel | indéterminée) ; action (aucune | à vérifier | intervention) ; son explication ; ce qu'il n'a pas pu établir ; la date de son avis.
|
||||
|
||||
Si l'expert ne donne pas la classification (liste fermée du §4.3 de la roadmap) ou cite une cause hors de la liste fermée du rapport (buée ou eau, occlusion, turbulence, éclairage, inconnue ; la neige est une occlusion), propose la correspondance dans ce même message et fais-la valider.
|
||||
|
||||
L'avis de l'expert reste dans la conversation jusqu'à l'étape 5 : rien de lui n'entre dans le dépôt avant le passage à l'aveugle, ni fichier, ni nom de fichier, ni message de commit.
|
||||
|
||||
## 2. Ranger les données (D-029, D-045)
|
||||
|
||||
- Export : `data/<STATION>/displacement/`, nom d'origine gardé. Dossier de station en majuscules, sans espace (`PS_DES_COUDRES`).
|
||||
- Images : `data/<STATION>/images/<AAAAMMJJ>T<HHMM>Z_<nom d'origine sans extension>.jpg`, heure en **UTC**, originaux laissés en place. Une heure locale se convertit, par exemple `date -u -d 'TZ="Europe/Zurich" 2026-11-03 20:00' +%Y%m%dT%H%MZ` (heure d'hiver ou d'été selon la date). Regarde-les : la nuit et le jour tombent aux bonnes heures UTC ; ni personne ni véhicule (dépôt privé, D-014), sinon demande.
|
||||
- Vérifie avec `python3 agents/diagnostic/outils/inventaire.py data/<STATION>/` : l'export est trouvé, il couvre la fenêtre, les images sont datées. Puis `resume.py` sur la fenêtre, avec les capteurs que cite l'expert : l'anomalie s'y voit.
|
||||
- Si les données contredisent l'expert (capteur absent, rien d'anormal dans la fenêtre), arrête-toi et dis-le.
|
||||
|
||||
## 3. Commit neutre, arbre propre
|
||||
|
||||
Le sous-agent reçoit la branche et les derniers messages de commit (§7 de la spec).
|
||||
- Commite par chemin, pour ne rien emporter d'autre de déjà indexé : `git add data/<STATION>/`, puis `git commit -m "Add <STATION> displacement export and camera images" -- data/<STATION>/`. Message neutre : rien sur l'incident, sa cause ou un cas. Branche au nom neutre.
|
||||
- `git status --short` doit être vide avant le lancement. Les fichiers en cours de quelqu'un d'autre : demande à l'utilisateur ; ne les commite pas et ne les mets pas de côté toi-même.
|
||||
|
||||
## 4. Passage à l'aveugle
|
||||
|
||||
1. Avant de lancer, écris dans la conversation les attendus tirés de l'avis de l'expert : l'anomalie, les capteurs touchés et des témoins intacts, la classification, aucune conclusion au-delà des preuves. Avec l'index tel qu'il est, l'agent répond « aucun cas connu » ou cite le bon cas, jamais un faux. Sans cas, une conséquence « indéterminée » est normale (asymétrie), ce n'est pas un défaut.
|
||||
2. Lance l'outil Agent, `subagent_type: diagnostic`, avec ce prompt et rien d'autre : `data/<STATION>/ que s'est-il passé du <début> au <fin> (UTC) ?`
|
||||
3. Fais un tableau attendu / résultat. Si un attendu est manqué ou une conclusion va au-delà des preuves, propose à l'utilisateur une correction **générale** de `agents/diagnostic/instructions.md`, sans nom de capteur ni de site. Si elle repose sur un jugement métier non confirmé, ne la code pas : elle va, avec sa question au spécialiste, dans « Test à l'aveugle » de la fiche. Une correction acceptée se commite avec le premier rapport, par chemin, sous un message neutre (`Fix <règle générale> in the diagnostic instructions`), puis reprends 4.2.
|
||||
4. Si seule la cause diverge, parce que les données ne la tranchent pas, ce n'est pas un défaut : elle va dans les inconnus de la fiche.
|
||||
|
||||
## 5. Écrire la fiche
|
||||
|
||||
- **Numéro** : le plus grand `C-xxx` de `agents/diagnostic/cas/INDEX.md`, plus un (C-001 si l'index est vide). Dossier : `agents/diagnostic/cas/C-xxx_<STATION>_<AAAA-MM-JJ du début>/`, `<STATION>` étant le nom du dossier de `data/`.
|
||||
- **`cas.md`** suit le modèle du §11.3 de la spec (`grep -n '^### 11.3' docs/agents/agent-diagnostic.md`, puis lis cette section seule) :
|
||||
- **Signature** et **Exclusions** : tirées des faits et des commandes du rapport à l'aveugle. Les critères sont observables, relatifs au niveau habituel du capteur (MAD), sans nom de capteur ni seuil absolu ; leurs commandes gardent les vrais noms, pour se rejouer. Chaque exclusion se vérifie avec les outils ;
|
||||
- **Diagnostic de l'expert** : avec ses mots ; la cause est aussi rapportée à la liste fermée du rapport (buée ou eau, occlusion, turbulence, éclairage, inconnue) ;
|
||||
- **Attendu de l'agent** : ce qu'il doit dire sur ces données sans ce cas dans l'index (le passage à l'aveugle), puis avec ;
|
||||
- **Preuves** : copie les PNG du rapport à côté de `cas.md` et regarde chacun ;
|
||||
- **Test à l'aveugle** : le chemin du rapport et le tableau de 4.3.
|
||||
- **Ligne d'index** : `| [C-xxx](C-xxx_<STATION>_<date>/cas.md) | <Station> · <fenêtre UTC> | <signature courte, observable> | <classification> | <cause de l'expert> | <conséquence, action> |`. Retire « *Base vide pour l'instant.* ».
|
||||
- **Validation du rapport à l'aveugle** : verdict accepté ou corrigé (en quoi) ; diagnostic final, celui de l'expert ; `Devient un cas : oui (C-xxx)`.
|
||||
- **Montre la fiche et la ligne d'index à l'utilisateur, et attends son accord** : c'est l'expert qui valide un cas, pas Claude.
|
||||
|
||||
## 6. Commit et test de correspondance
|
||||
|
||||
1. Commite par chemin `agents/diagnostic/cas/` et le rapport, avec le message `Add case C-xxx to the diagnostic case base` ; l'arbre est alors propre.
|
||||
2. Relance l'agent avec le même prompt (4.2), cette fois avec le cas dans l'index. Attendu : `C-xxx, complète` (ou partielle s'il manque une donnée), et le diagnostic de l'expert ; « aucune » conséquence seulement si la règle d'asymétrie le permet. Ce passage vérifie la mécanique de correspondance, pas le jugement : l'agent a lu la fiche.
|
||||
3. Si le cas ne correspond pas, la signature est trop stricte ou trop vague : corrige la fiche et relance. Consigne le résultat dans « Test à l'aveugle » de la fiche, même s'il réussit du premier coup, puis commite par chemin la fiche et le second rapport (`Record the C-xxx match test`).
|
||||
|
||||
Pour un cas, ne touche ni à `CLAUDE.md`, ni à la spec, ni à `docs/decisions.md` : l'index est le registre.
|
||||
Reference in new issue
Block a user