- inventaire.py: what each source contains on the window (filled or empty columns, metric names, images), names and counts only - analyser-lot: step 0 on the data, own scripts in <lot>/outils/, section 3 "Outils" - tool-builder (the optimiser, rewritten): after the analyst, optimises or adds reading tools, never removes; no control yet - /aiguiser skill, reader, corrector and voir.py removed; its sessions and spec stay as history - docs: D-097, specs, CLAUDE.md, run.md, README, plan point 56; the shared files also carry another session's pending edits (D-096 entry, plan points 57 to 67) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
10 KiB
name, description, disable-model-invocation, argument-hint
| name | description | disable-model-invocation | argument-hint |
|---|---|---|---|
| new-event | Ajouter un incident validé par l'expert à la base d'events 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 /new-event. | true | [fichiers ou dossier des données] [station] [fenêtre UTC] |
Ajouter un event à la base de l'agent de diagnostic
Un event, c'est un incident (station, fenêtre) et le diagnostic de l'expert, rangés dans events/ (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 de l'event. Lancer ce skill est la demande explicite d'ajout ; des données reçues ou un rapport validé n'ajoutent jamais un event 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, D-065)
- Données : pompées dans
data/<STATION>/(run.md,<STATION>= numéro de série du système). Si la fenêtre n'y est pas, donne à l'utilisateur la commande du pompage sur la fenêtre, 3 jours de plus avant, avec--images(--every 10pour une image par mesure à 10 min), et attends. - Export reçu à la main, à défaut :
data/<STATION>/displacement/, nom d'origine gardé. - Images reçues à la main :
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 agent-tools/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).
data/est hors de git (D-065) : rien à y committer. Branche au nom neutre : rien sur l'incident, sa cause ou un event.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 event connu » ou cite le bon event, jamais un faux. Sans event, 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
agent-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
E-xxxdeevents/INDEX.md, plus un (E-001 si l'index est vide). Dossier :events/E-xxx/. - Données : copie-les dans le dossier de l'event, noms codés, avec le skill
anonymize-event(étape 1), avant les figures (D-050). event.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 cet event : ni les éventualités d'autres events (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 de l'event, 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 de l'event 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 de l'event (skill
anonymize-event, étape 2), puis regarde chacune ; chaque légende commence par les critères qu'elle montre.
- Ligne d'index :
| [E-xxx](E-xxx/event.md) | <événement, UTC> | <signature courte, observable> | <classification> | <cause, niveau de preuve> | <verdict court> |, la signature d'environ 250 caractères, une indication et non une limite, le détail allant dans la fiche (D-085). 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 event : oui (E-xxx). - Anonymise avec le skill
anonymize-event(étape 3) : la station devientE-xxx, les capteursR1,C1, et aucun nom réel ne reste (D-049, D-050). - Étiquettes de l'event (D-069), pour le benchmark des détecteurs : l'outil Agent,
subagent_type: analyste, avec cette demande (<lot>: première mesure de l'event → dernière plus un pas, UTC) :Étiquettes d'un event de la base (benchmark des détecteurs, D-069), pas un lot de la boucle. Dossier de station : events/E-xxx/ (noms codés). Lot : <lot>. Dossier de sortie, pour tes figures : out/benchmark/E-xxx/. Fais les étapes 0 à 2 d'analyser-lot : tes données, ta lecture, sans les détecteurs ni la base d'events (les étiquettes du benchmark ne doivent rien leur devoir), puis tes étiquettes (section « Les étiquettes », "station": "E-xxx"), contrôlées par python3 .claude/skills/analyser-lot/etiquettes.py events/E-xxx events/E-xxx/etiquettes.json jusqu'à « bon ». Ensuite seulement, lis la fiche events/E-xxx/event.md, validée par l'expert, corrige les étiquettes qu'elle contredit (en réécrivant le fichier avec Write) et recontrôle. Écris events/E-xxx/etiquettes.json etevents/E-xxx/etiquetage.md, dans cet ordre de sections : ta lecture (le tableau des moments de lire-les-donnees, avec la catégorie de chacun), « Ce que la fiche a changé », « Sources lues », « Difficultés ». Réponds en 3 lignes.Le rendu,etiquetage.md, reste dans le dossier de l'event, à côté de ses étiquettes. - Carte des événements (D-087) : écris dans
events/carte-des-evenements.mdce que l'event enseigne, général, sans code de capteur ni chiffre propre à l'event : l'event dans « Event / source » de son événement (section 1), un trait nouveau dans « Ce qu'on voit », ou une ligne de plus ; une ressemblance trompeuse dans la section 5, « Faux amis ». - Montre la fiche, la ligne d'index et le diff de la carte à l'utilisateur, et attends son accord : c'est l'expert qui valide un event, pas Claude.
6. Commit et test de correspondance
- Commite par chemin
events/, le registre.claude/skills/anonymize-event/registre.csvet le rapport, avec le messageAdd event E-xxx to the diagnostic event base; l'arbre est alors propre. - Relance l'agent avec le même prompt (4.2), cette fois avec l'event dans l'index. Attendu :
E-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 l'event 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 E-xxx match test), même s'il réussit du premier coup : la fiche ne raconte pas ses tests.
Pour un event, ne touche ni à CLAUDE.md, ni à la spec, ni à docs/decisions.md : l'index est le registre.