- docs/displacement/domaine/incident-de-barcelone.md: the AIMsight regression case is data/CLARIDEN/ (case C-004); what the data show, the documentation's reading (reference/compensation instability) against the expert's (real movement of the structure, confirmed by other instruments, amplitude likely overestimated), open questions. - nouveau-cas: platform zips date images in UTC, exports cover local days; keep every image of the range, even at 10 min. - colonnes-des-deplacements: native cadence is 15 or 10 min. - CLAUDE.md: four cases in the base, displacement data of NORDEND, WILDSTRUBEL and CLARIDEN. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
8.4 KiB
name, description, disable-model-invocation, argument-hint
| name | description | disable-model-invocation | argument-hint |
|---|---|---|---|
| nouveau-cas | 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. | true | [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, son lieu (région, pays) 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. Les zips de la plateforme datent chaque image en UTC dans son entrée (vérifié sur CLARIDEN : l'image se décale à l'instant où les mesures sautent) ; l'export couvre, lui, des jours locaux (début à 22:00Z la veille en été) : 2 h d'écart entre les deux plages sont normales. Garde toutes les images de la plage, même à 10 min : une par mesure. Une heure locale se convertit, par exempledate -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. Puisresume.pysur 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>/, puisgit 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 --shortdoit ê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
- 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.
- 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) ? - 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 : pose la question à l'utilisateur ; sa réponse va dans le Diagnostic de la fiche (le fait, et ce qu'en dit l'expert). 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. - Si seule la cause diverge, parce que les données ne la tranchent pas, ce n'est pas un défaut : ce qui ne se tranche pas va dans la ligne Cause du Diagnostic.
5. Écrire la fiche
- Numéro : le plus grand
C-xxxdeagents/diagnostic/cas/INDEX.md, plus un (C-001 si l'index est vide). Dossier :agents/diagnostic/cas/C-xxx/. - Données : copie-les dans le dossier du cas, noms codés, avec le skill
anonymiser-cas(étape 1), avant les figures (D-050). cas.mdsuit le modèle du §11.3 de la spec (grep -n '^### 11.3' docs/agents/agent-diagnostic.md, puis lis cette section seule) :- seulement ce cas : ni les éventualités d'autres cas (pas d'exclusions), ni l'historique des tests (D-051) ;
- Résumé, Symptôme, Verdict : pour un humain, courts, sans chiffre ; le Verdict garde le niveau de preuve de la cause ;
- Signature : tirée 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 s'écrivent sur le dossier du cas, avec les codes, pour se rejouer telles quelles ;
- Diagnostic : listes fermées (classification ; cause rapportée à la liste du rapport : buée ou eau, occlusion, turbulence, éclairage, inconnue ; conséquence ; action), le mécanisme en une phrase, et chaque fait du cas qui pourrait tromper l'agent, avec ce qu'en dit l'expert ;
- Preuves : refais les figures du rapport avec leurs commandes, sur les données du cas (skill
anonymiser-cas, étape 2), puis regarde chacune ; chaque légende commence par les critères qu'elle montre.
- Ligne d'index :
| [C-xxx](C-xxx/cas.md) | <événement, UTC> | <signature courte, observable> | <classification> | <cause, niveau de preuve> | <verdict court> |. 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). - Anonymise avec le skill
anonymiser-cas(étape 3) : la station devientC-xxx, les capteursR1,C1, et aucun nom réel ne reste (D-049, D-050). - 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
- Commite par chemin
agents/diagnostic/cas/, le registre.claude/skills/anonymiser-cas/registre.csvet le rapport, avec le messageAdd case C-xxx to the diagnostic case base; l'arbre est alors propre. - 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. - Si le cas ne correspond pas, la signature est trop stricte ou trop vague : corrige la fiche et relance. Commite par chemin le second rapport, et la fiche si tu l'as corrigée, avec le résultat dans le message (
Record the C-xxx match test), même s'il réussit du premier coup : la fiche ne raconte pas ses tests.
Pour un cas, ne touche ni à CLAUDE.md, ni à la spec, ni à docs/decisions.md : l'index est le registre.