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.
|
||||
@@ -11,7 +11,7 @@ Un sous-agent Claude Code qui diagnostique les données d'une station : il repè
|
||||
|
||||
## Ce qu'il rend
|
||||
|
||||
Un dossier par diagnostic dans `rapports/` : `rapport.md` (verdict, une section courte par anomalie avec ses figures, « Hors anomalie », annexe) et ses figures PNG ; un résumé dans la conversation. La section « Validation » du rapport est à remplir ; « Devient un cas : oui » y demande d'en faire un cas (ci-dessous).
|
||||
Un dossier par diagnostic dans `rapports/` : `rapport.md` (verdict, une section courte par anomalie avec ses figures, « Hors anomalie », annexe) et ses figures PNG ; un résumé dans la conversation. La section « Validation » du rapport est à remplir ; « Devient un cas » y note la décision ; l'ajout se fait par `/nouveau-cas` (ci-dessous).
|
||||
|
||||
## Contenu du dossier
|
||||
|
||||
@@ -22,12 +22,7 @@ Un dossier par diagnostic dans `rapports/` : `rapport.md` (verdict, une section
|
||||
|
||||
## Ajouter un cas
|
||||
|
||||
Seulement sur demande explicite de l'utilisateur : en conversation, ou « Devient un cas : oui » dans la validation d'un rapport. Recevoir des données ou valider un rapport sans ce « oui » ne suffit pas.
|
||||
|
||||
1. Les données vont dans `data/<STATION>/` (D-029) ; l'avis de l'expert reste hors du dépôt jusqu'à l'étape 4.
|
||||
2. Commiter (arbre propre : un `git status` sale a déjà fuité), puis lancer l'agent à l'aveugle sur la fenêtre de l'incident : `@agent-diagnostic data/<STATION>/ que s'est-il passé du <début> au <fin> (UTC) ?`. Il doit répondre « aucun cas connu » ou citer le bon cas, jamais un faux.
|
||||
3. Comparer son rapport à l'avis de l'expert ; un attendu manqué se corrige dans `instructions.md`.
|
||||
4. Écrire `cas/C-<numéro>_<STATION>_<AAAA-MM-JJ>/cas.md` au modèle du §11.3 de la spec (signature tirée des faits et des commandes du rapport, diagnostic de l'expert), y copier les figures du rapport, ajouter sa ligne à `cas/INDEX.md` (et retirer « Base vide pour l'instant »), commiter.
|
||||
Avec le skill `/nouveau-cas` (`.claude/skills/nouveau-cas/SKILL.md`), que seul l'utilisateur lance : de nouvelles données et le diagnostic de l'expert donnent un cas, après un passage de l'agent à l'aveugle et un test de correspondance. Rien d'autre n'ajoute un cas.
|
||||
|
||||
**Rejouer un cas** : retirer sa ligne de `cas/INDEX.md` sans commiter, lancer l'agent sur sa fenêtre, comparer son rapport à « Attendu de l'agent » de la fiche, restaurer la ligne (`git checkout agents/diagnostic/cas/INDEX.md`).
|
||||
|
||||
|
||||
@@ -112,7 +112,7 @@ Un dossier par diagnostic, `agents/diagnostic/rapports/<AAAA-MM-JJTHHMMZ>_<STATI
|
||||
- les commandes de chaque fait, repliées (`<details>`).
|
||||
4. **Hors anomalie** : trois lignes au plus.
|
||||
5. **Annexe** : sources lues, données disponibles et manquantes, seuil de repérage.
|
||||
6. **Validation**, laissée vide pour l'utilisateur : accepté tel quel ou corrigé (en quoi), diagnostic final, devient un cas (oui, C-xxx, ou non) ; ce « oui » déclenche l'ajout (§11.6).
|
||||
6. **Validation**, laissée vide pour l'utilisateur : accepté tel quel ou corrigé (en quoi), diagnostic final, devient un cas (oui, C-xxx, ou non) ; l'ajout se lance par `/nouveau-cas` (§11.6).
|
||||
|
||||
## 6. Outils (`agents/diagnostic/outils/`)
|
||||
|
||||
@@ -220,7 +220,7 @@ Rapport : `agents/diagnostic/rapports/2026-10-14T1357Z_PS_DES_COUDRES/` ; 38 app
|
||||
| Granularité | **Une fiche par incident** : un upload donne un dossier |
|
||||
| Cas reçus | **Les données et le diagnostic de l'expert** |
|
||||
| Sans cas correspondant | **Les faits, puis les hypothèses de l'agent marquées « non validé »**, pour le support seulement |
|
||||
| Ajout d'un cas | **Seulement sur demande explicite de l'utilisateur** ; jamais de lui-même, même à la réception de données |
|
||||
| Ajout d'un cas | **Seulement sur demande explicite de l'utilisateur** ; jamais de lui-même, même à la réception de données ; skill `/nouveau-cas`, lancé par l'utilisateur seul |
|
||||
|
||||
La plage sélectionnée par « Analyze » est le mode question actuel (§4) restreint à une fenêtre ; rien ne change à l'entrée de l'agent.
|
||||
|
||||
@@ -291,7 +291,7 @@ Ce qui ferait que ce n'est pas ce cas :
|
||||
- **Signature et exclusions** portent la recherche et la comparaison : l'agent les coche avec ses outils. Relatives (en MAD), jamais en seuil absolu, qui ne se transpose pas d'une station à l'autre.
|
||||
- **Conséquence pour l'ouvrage et action** : deux listes fermées, ce dont le bouton « Analyze » a besoin.
|
||||
- **Symptôme** : prépare la future question en texte libre (§11.8).
|
||||
- **Attendu de l'agent** : le cas est aussi un test de régression, y compris du refus de conclure au-delà des preuves (§17 du contexte support).
|
||||
- **Attendu de l'agent** : le cas est aussi un test de régression, y compris du refus de conclure au-delà des preuves (§17 du contexte support). Il décrit ce que l'agent doit dire sans ce cas dans l'index (passage à l'aveugle), puis avec (test de correspondance, §11.6).
|
||||
- **Figures copiées** du rapport dans le dossier du cas : l'agent ne lit pas `rapports/`, et un cas reste complet sans son rapport.
|
||||
|
||||
### 11.4 Usage par l'agent
|
||||
@@ -316,16 +316,20 @@ Sources (§2 de `instructions.md`) : `cas/INDEX.md` et les fiches qu'il cite, av
|
||||
- Chaque anomalie gagne une ligne : **Cas connu** : C-xxx, complète (critères 1 à 4 vérifiés, aucune exclusion) | partielle (critère 4 non vérifiable : pas d'image) | aucun cas connu.
|
||||
- La ligne de classification gagne **Conséquence pour l'ouvrage** et **Action**, les listes fermées de la fiche.
|
||||
- Sans cas correspondant, les hypothèses sont titrées « Non validé (support) ».
|
||||
- La validation gagne une ligne : « Devient un cas : oui (C-xxx) | non ». Ce « oui » de l'utilisateur est la demande explicite qui déclenche §11.6.
|
||||
- La validation gagne une ligne : « Devient un cas : oui (C-xxx) | non ». Elle note la décision ; l'ajout se lance par `/nouveau-cas` (§11.6).
|
||||
|
||||
### 11.6 Ajouter un cas (sur demande explicite seulement)
|
||||
### 11.6 Ajouter un cas : le skill `/nouveau-cas`
|
||||
|
||||
Procédure dans `agents/diagnostic/README.md`. Elle ne démarre que sur demande explicite de l'utilisateur (en conversation, ou « Devient un cas : oui » dans la validation d'un rapport) ; recevoir des données ou valider un rapport sans ce « oui » ne suffit pas.
|
||||
Procédure tenue par `.claude/skills/nouveau-cas/SKILL.md`, avec `disable-model-invocation` : seul l'utilisateur la lance. Recevoir des données ou valider un rapport n'ajoute pas de cas.
|
||||
|
||||
1. Les données vont dans `data/<STATION>/` ; l'avis de l'expert reste hors du dépôt (dans la conversation) jusqu'à l'étape 4.
|
||||
2. L'agent tourne à l'aveugle, la fenêtre de l'incident pour question (comme « Analyze »), sur un arbre propre (après commit : le `git status` d'un arbre sale a déjà fuité, §7).
|
||||
3. Son rapport est comparé à l'avis de l'expert ; un attendu manqué se corrige dans `instructions.md`.
|
||||
4. La fiche s'écrit (signature tirée des faits et commandes du rapport, diagnostic de l'expert), les figures sont copiées, la ligne d'index ajoutée.
|
||||
1. **Réunir** en un message : fichiers, station, fenêtre en UTC, diagnostic de l'expert (symptôme, classification, cause, conséquence, action, explication, inconnus, date). L'avis de l'expert reste dans la conversation jusqu'à l'étape 5.
|
||||
2. **Ranger** les données (D-029, D-045) : export dans `data/<STATION>/displacement/`, images renommées en UTC (`<AAAAMMJJ>T<HHMM>Z_<n>.jpg`) ; contrôle par `inventaire.py`.
|
||||
3. **Commit neutre** (rien sur l'incident ni sa cause : le sous-agent reçoit les derniers messages de commit et la branche), arbre propre.
|
||||
4. **Passage à l'aveugle**, la fenêtre de l'incident pour question, comparé à des attendus écrits avant ; un attendu manqué se corrige dans `instructions.md` par une règle générale.
|
||||
5. **Fiche** (signature tirée du rapport, diagnostic de l'expert, figures copiées) et ligne d'index avec lien, montrées à l'utilisateur et validées avant commit.
|
||||
6. **Test de correspondance** : l'agent relancé, le cas dans l'index, doit trouver `C-xxx, complète` (ou partielle) et le diagnostic de l'expert. Il vérifie la mécanique, pas le jugement : l'agent a lu la fiche.
|
||||
|
||||
Un cas ne touche ni `CLAUDE.md`, ni cette spec, ni `docs/decisions.md` : l'index est le registre.
|
||||
|
||||
### 11.7 Vérification
|
||||
|
||||
@@ -350,7 +354,6 @@ Procédure dans `agents/diagnostic/README.md`. Elle ne démarre que sur demande
|
||||
|
||||
### 11.8 Laissé de côté
|
||||
|
||||
- **Skill `nouveau-cas`** : quand la procédure §11.6 aura servi deux ou trois fois sans changer.
|
||||
- **Filtre structuré** (en-tête de fiche et script `cas.py`), puis peut-être **RAG vectorielle** : quand l'index ne tiendra plus en une lecture (quelques centaines de cas), ou quand la question arrivera en texte libre (ticket, client) : le champ Symptôme y prépare.
|
||||
- **Entrée « fenêtre » dédiée** pour le bouton : le mode question la couvre.
|
||||
|
||||
|
||||
+1
-1
@@ -530,7 +530,7 @@ Règles du journal :
|
||||
- **Conséquence** : l'avis du spécialiste devient le cas de référence de l'agent (§7 de `docs/agents/agent-diagnostic.md`) ; des PNG entrent dans le dépôt, quelques centaines de Ko par rapport.
|
||||
|
||||
## D-048 — 2026-10-14 — Agent de diagnostic : une base de cas validés, consultée après les faits
|
||||
- **Statut** : active, construite le 2026-10-14 (spec : §11 de `docs/agents/agent-diagnostic.md`) ; base vide. Remplace en partie D-042 (base de cas chargée dans le prompt).
|
||||
- **Statut** : active, construite le 2026-10-14 (spec : §11 de `docs/agents/agent-diagnostic.md`) ; base vide ; ajout d'un cas par le skill `/nouveau-cas`, lancé par l'utilisateur seul. Remplace en partie D-042 (base de cas chargée dans le prompt).
|
||||
- **Décision** :
|
||||
- une base de cas validés par l'expert, `agents/diagnostic/cas/` : `INDEX.md`, une ligne par incident (signature observable, classification, cause, verdict), et un dossier par incident avec sa fiche `cas.md` (symptôme, signature, exclusions, diagnostic de l'expert avec conséquence pour l'ouvrage et action en listes fermées, attendu de l'agent, inconnus, figures, test à l'aveugle) ; les données restent dans `data/` ;
|
||||
- l'agent lit l'index **après** avoir établi ses faits, ouvre au plus 3 fiches par anomalie et coche critères et exclusions avec ses outils : correspondance complète, partielle ou aucune ;
|
||||
|
||||
Reference in new issue
Block a user