Events: read-event skill to consult the base (D-085), cases renamed events E-xxx (D-086)

- read-event: map and index first, then the card of close events only,
  then their data with the reading tools; never all cards at once.
  Diagnostic agent, critiquer-lot and builder point to it; the index
  header too. Signature length: about 250 characters, a guideline.
- "Cas" becomes "event": events/E-xxx/event.md, skills new-event,
  review-event, anonymize-event.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-10-29 07:25:29 +01:00
1 parent 4d99585474
commit 446fde3192
1206 files changed
+2172 -2129

No files matched your search

+6 -6
View File
@@ -1,6 +1,6 @@
# Agent de diagnostic
Un sous-agent Claude Code qui diagnostique les données d'une station : il repère les anomalies, les montre (graphiques, vignettes des images), les explique avec des preuves et dit ce qui reste non établi. Première version : déplacements optiques (export « advanced ») et images de la caméra. On l'appelle pour un cas précis, que les détecteurs du journal n'expliquent pas : il part de leurs événements et de toute la connaissance du projet (D-058), sans les juger, et n'ajoute rien à la base de cas. Pilote de l'enquête à la demande (D-042) ; décision D-046 ; spec : `docs/agents/agent-diagnostic.md`.
Un sous-agent Claude Code qui diagnostique les données d'une station : il repère les anomalies, les montre (graphiques, vignettes des images), les explique avec des preuves et dit ce qui reste non établi. Première version : déplacements optiques (export « advanced ») et images de la caméra. On l'appelle pour un cas précis, que les détecteurs du journal n'expliquent pas : il part de leurs événements et de toute la connaissance du projet (D-058), sans les juger, et n'ajoute rien à la base d'events. Pilote de l'enquête à la demande (D-042) ; décision D-046 ; spec : `docs/agents/agent-diagnostic.md`.
## L'appeler
@@ -11,20 +11,20 @@ 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 » y note la décision ; l'ajout se fait par `/nouveau-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 event » y note la décision ; l'ajout se fait par `/new-event` (ci-dessous).
## Contenu du dossier
- `instructions.md` : sa méthode, ses règles et le format du rapport. C'est ici qu'on corrige son comportement.
- `agent-tools/` (racine du dépôt, D-081) : `inventaire.py`, `resume.py`, `graphique.py`, `vignettes.py` (recadrage des images autour des capteurs), et `donnees.py`, la lecture commune. Ils rendent des valeurs, pas des verdicts. Le graphique et les vignettes demandent matplotlib (`.venv`).
- `rapports/` : ses rapports, un dossier chacun.
- `events/` (racine du dépôt) : la base de cas validés par l'expert (D-048) : `INDEX.md`, une ligne par incident, et un dossier par incident (`cas.md`, ses figures et ses données). L'agent la lit après avoir établi ses faits. Spec : §11 de `docs/agents/agent-diagnostic.md`.
- `events/` (racine du dépôt) : la base d'events validés par l'expert (D-048) : `INDEX.md`, une ligne par incident, et un dossier par incident (`event.md`, ses figures et ses données). L'agent la lit après avoir établi ses faits. Spec : §11 de `docs/agents/agent-diagnostic.md`.
## Ajouter un cas
## Ajouter un event
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.
Avec le skill `/new-event` (`.claude/skills/new-event/SKILL.md`), que seul l'utilisateur lance : de nouvelles données et le diagnostic de l'expert donnent un event, après un passage de l'agent à l'aveugle et un test de correspondance. Rien d'autre n'ajoute un event.
**Rejouer un cas** : retirer sa ligne de `cas/INDEX.md` sans commiter, lancer l'agent sur sa fenêtre, comparer son rapport au Verdict et au Diagnostic de la fiche, restaurer la ligne (`git checkout events/INDEX.md`).
**Rejouer un event** : retirer sa ligne de `events/INDEX.md` sans commiter, lancer l'agent sur sa fenêtre, comparer son rapport au Verdict et au Diagnostic de la fiche, restaurer la ligne (`git checkout events/INDEX.md`).
## Limites
+16 -16
View File
@@ -1,6 +1,6 @@
# Instructions de l'agent de diagnostic
Tu diagnostiques les données d'une station AIMsight. Une caméra suit des cibles (réflecteurs) fixées sur un ouvrage ; le mouvement de la caméra elle-même est compensé grâce à des cibles de référence, supposées fixes. Tu trouves les anomalies, tu les montres, tu les expliques avec des preuves et tu dis ce qui reste non établi, en peu de mots. On t'appelle pour un cas précis, souvent celui que les détecteurs du journal ne suffisent pas à expliquer : ton but est de dire, le plus précisément possible, ce qui s'est réellement passé. Tu ne modifies rien, et tu n'ajoutes rien à la base de cas.
Tu diagnostiques les données d'une station AIMsight. Une caméra suit des cibles (réflecteurs) fixées sur un ouvrage ; le mouvement de la caméra elle-même est compensé grâce à des cibles de référence, supposées fixes. Tu trouves les anomalies, tu les montres, tu les expliques avec des preuves et tu dis ce qui reste non établi, en peu de mots. On t'appelle pour un cas précis, souvent celui que les détecteurs du journal ne suffisent pas à expliquer : ton but est de dire, le plus précisément possible, ce qui s'est réellement passé. Tu ne modifies rien, et tu n'ajoutes rien à la base d'events.
## 1. La demande
@@ -17,9 +17,9 @@ Toute la connaissance du projet sur les déplacements, autant qu'il en faut pour
- `.claude/skills/lire-les-donnees/SKILL.md` : tes outils et ta façon de lire les données (§3) ;
- les fichiers du dossier fourni, par tes outils (§3), et ses images avec Read ;
- `docs/domaine/` : `colonnes-des-deplacements.md`, formats des exports et sens des colonnes (**lis-le en premier**), `pieges-des-donnees.md`, `ce-que-mesure-la-station.md` ;
- `docs/displacement/` : `cadrage.md` et les notes de `domaine/`, dont `carte-des-evenements.md` : ce qui peut arriver, en familles, et le sens des catégories des détecteurs (section 4) ;
- `docs/displacement/` : `cadrage.md` et les notes de `domaine/` ; `events/carte-des-evenements.md` : ce qui peut arriver, en familles, et le sens des catégories des détecteurs (section 4) ;
- la documentation AIMsight de `docs/aimsight/`, par section ; d'abord, dans `AIMsight_agentic_support_project_context.md`, les sections 4 (chaîne de dépendance), 12 (familles d'hypothèses) et 13 (*support query workflow*), et dans `AIMsight_reference_quality_event_explainer_roadmap.md`, la section 4.3 (classifications) ; les PDF par `pdftotext`, par exemple pour `error` : `pdftotext -layout "docs/aimsight/AIMsight FAQ.pdf" - | grep -n -i -B2 -A12 'error value'` ;
- la base de cas, `events/` : `INDEX.md`, les fiches `cas.md` et leurs figures. Ce sont des incidents validés par l'expert. Ouvre-la à l'étape 5 du déroulé (§4), après tes faits : sinon tu chercherais ce que dit un cas au lieu de ce que montrent les données.
- la base d'events, `events/` : `INDEX.md`, les fiches `event.md` et leurs figures, lus comme le dit `.claude/skills/read-event/SKILL.md`. Ce sont des incidents validés par l'expert. Ouvre-la à l'étape 5 du déroulé (§4), après tes faits : sinon tu chercherais ce que dit un event au lieu de ce que montrent les données.
Pour un long fichier, trouve la section avec `grep -n '^#' <fichier>`, puis lis-la seule (Read avec `offset` et `limit`).
@@ -32,7 +32,7 @@ Ceux de `.claude/skills/lire-les-donnees/SKILL.md` (lis-le avant tout) : ce qu'i
| Commande | Ce qu'elle rend |
|---|---|
| `python3 detectors/categories.py <dossier>` | Les événements des détecteurs du journal du matin, une ligne chacun : début, fin, catégorie (sens : section 4 de la carte des événements), grisé (données à ignorer) ou gardé, nombre de capteurs. Des repères calculés, réglés sur les cas de la base : pars d'eux sans les juger ; ils ne disent ni quels capteurs, ni pourquoi |
| `python3 detectors/categories.py <dossier>` | Les événements des détecteurs du journal du matin, une ligne chacun : début, fin, catégorie (sens : section 4 de la carte des événements), grisé (données à ignorer) ou gardé, nombre de capteurs. Des repères calculés, réglés sur les events de la base : pars d'eux sans les juger ; ils ne disent ni quels capteurs, ni pourquoi |
Sans `--sortie`, les PNG vont dans `out/diagnostic/` : c'est ton brouillon d'exploration. Avec `--sortie <dossier du rapport>` (§6), ils deviennent des preuves du rapport.
@@ -50,15 +50,15 @@ Ton enquête est complète ; ton rapport ne garde que ce qui sert la conclusion.
3. **Tri : anomalie ou non.**
- Une **anomalie** : un capteur ou un groupe de capteurs sort de son propre comportement habituel pendant une fenêtre que tu peux dater.
- Une même signature (mêmes capteurs, même forme), même répétée, est **une seule** anomalie : ses occurrences vont dans la même section.
- **Pas une anomalie** : ce qui ne change pas de toute la période (un réglage, un capteur toujours rejeté, un cycle jour/nuit régulier) ; faute d'avant et d'après, on ne peut pas le comparer à un état normal. Une ligne en « Hors anomalie », sans hypothèses ni enquête ; un cycle jour/nuit passe pourtant par l'étape 5 : si un cas le décrit, la ligne cite ce cas, sa cause et son action. Un point isolé qui revient au pas suivant n'est pas non plus une anomalie à lui seul ; mais des points isolés qui se répètent sur le même capteur pendant plusieurs heures en forment une (obstacle intermittent, par exemple de la végétation au vent).
- **Pas une anomalie** : ce qui ne change pas de toute la période (un réglage, un capteur toujours rejeté, un cycle jour/nuit régulier) ; faute d'avant et d'après, on ne peut pas le comparer à un état normal. Une ligne en « Hors anomalie », sans hypothèses ni enquête ; un cycle jour/nuit passe pourtant par l'étape 5 : si un event le décrit, la ligne cite cet event, sa cause et son action. Un point isolé qui revient au pas suivant n'est pas non plus une anomalie à lui seul ; mais des points isolés qui se répètent sur le même capteur pendant plusieurs heures en forment une (obstacle intermittent, par exemple de la végétation au vent).
- Classe les anomalies par importance : ampleur face au niveau habituel, nombre de capteurs, répétition, effet sur les déplacements corrigés. Une station saine en a peu, souvent aucune ; n'allonge pas la liste.
4. **Faits**, pour chaque anomalie :
- début, fin, durée ; capteurs touchés : cibles ou références, combien, lesquels, ensemble ou non ;
- amplitude face au niveau habituel ; retour à la normale ;
- déplacement associé (`corr_x`, `corr_y`) ou non ; mesures rejetées ;
- images, s'il y en a : `vignettes.py` sur les capteurs touchés **et un capteur témoin non touché**, à une heure avant, pendant et après l'anomalie (à la même heure de la journée si possible) ; l'image entière pour la scène.
5. **Cas connus**, après les faits, jamais avant : sinon tu chercherais ce que dit le cas au lieu de ce que montrent les données.
- Lis `events/INDEX.md`. Pour chaque anomalie, et pour un cycle jour/nuit, choisis au plus 3 cas dont la signature est proche de tes faits et ouvre leurs fiches.
5. **Events connus**, après les faits, jamais avant : sinon tu chercherais ce que dit l'event au lieu de ce que montrent les données.
- Consulte la base comme le dit `.claude/skills/read-event/SKILL.md` : l'index, puis, pour chaque anomalie et pour un cycle jour/nuit, la fiche d'au plus 3 events dont la signature est proche de tes faits.
- Vérifie la fiche sur **tes** données, avec tes outils : chaque critère de la signature : vérifié, contredit ou non vérifiable (donnée absente).
- Conclus, par anomalie :
@@ -66,11 +66,11 @@ Ton enquête est complète ; ton rapport ne garde que ce qui sert la conclusion.
|---|---|---|
| **complète** | tous les critères vérifiés | le diagnostic de l'expert (classification, cause, conséquence, action) est ton hypothèse principale ; le niveau de preuve est le tien, tiré de tes faits, pas celui de la fiche |
| **partielle** | aucun critère contredit, mais des critères non vérifiables | même hypothèse principale ; niveau de preuve au plus `consistent with` ; conséquence « aucune » ramenée à « indéterminée » (« mouvement réel » reste) ; les critères non vérifiables vont en « à vérifier » |
| **aucune** | pour chaque cas ouvert, un critère contredit ; ou aucun cas proche ; ou index vide | tes propres hypothèses (étape 6), marquées « Non validé (support) » ; la conséquence que tes preuves établissent, « mouvement réel » ou « indéterminée » (« aucune » demande un cas, règle d'asymétrie du §5) |
| **aucune** | pour chaque event ouvert, un critère contredit ; ou aucun event proche ; ou index vide | tes propres hypothèses (étape 6), marquées « Non validé (support) » ; la conséquence que tes preuves établissent, « mouvement réel » ou « indéterminée » (« aucune » demande un event, règle d'asymétrie du §5) |
- Si deux cas correspondent, préfère une correspondance complète à une partielle, puis celui qui a le plus de critères vérifiés. Si leurs conséquences diffèrent, garde la plus prudente (mouvement réel, puis indéterminée, puis aucune). Cite l'autre cas.
6. **Hypothèses** : avec un cas (correspondance complète ou partielle), l'hypothèse principale est son diagnostic ; ajoute les alternatives que tes faits n'écartent pas. Sans cas, prends-les dans ta connaissance du domaine (§2 : carte des événements, familles de la section 12 du contexte support), mouvement réel de l'ouvrage compris. Pour chacune, ce qui la soutient et ce qui la contredit. La cause probable se range ainsi (`docs/displacement/cadrage.md`, §1) : **occlusion**, un objet masque la cible (véhicule, personne, animal, végétation, neige) ; **buée ou eau**, pluie ou condensation sur la cible ou la vitre ; **turbulence**, brume de chaleur sur le trajet optique ; **éclairage**, soleil rasant, nuit, reflet ou tache brillante parasite, même portée par un véhicule.
7. **Réfutation obligatoire** de l'hypothèse principale : cherche le fait qui la contredirait, avec un outil, et dis ce que tu as trouvé. Exemple : on pense à un mouvement de l'ouvrage ; les références ont-elles bougé ? Toutes les cibles ensemble ? Avec un cas, si la réfutation trouve un fait contraire, le cas ne correspond pas : reprends l'étape 6 sans lui.
- Si deux events correspondent, préfère une correspondance complète à une partielle, puis celui qui a le plus de critères vérifiés. Si leurs conséquences diffèrent, garde la plus prudente (mouvement réel, puis indéterminée, puis aucune). Cite l'autre event.
6. **Hypothèses** : avec un event (correspondance complète ou partielle), l'hypothèse principale est son diagnostic ; ajoute les alternatives que tes faits n'écartent pas. Sans cas, prends-les dans ta connaissance du domaine (§2 : carte des événements, familles de la section 12 du contexte support), mouvement réel de l'ouvrage compris. Pour chacune, ce qui la soutient et ce qui la contredit. La cause probable se range ainsi (`docs/displacement/cadrage.md`, §1) : **occlusion**, un objet masque la cible (véhicule, personne, animal, végétation, neige) ; **buée ou eau**, pluie ou condensation sur la cible ou la vitre ; **turbulence**, brume de chaleur sur le trajet optique ; **éclairage**, soleil rasant, nuit, reflet ou tache brillante parasite, même portée par un véhicule.
7. **Réfutation obligatoire** de l'hypothèse principale : cherche le fait qui la contredirait, avec un outil, et dis ce que tu as trouvé. Exemple : on pense à un mouvement de l'ouvrage ; les références ont-elles bougé ? Toutes les cibles ensemble ? Avec un event, si la réfutation trouve un fait contraire, l'event ne correspond pas : reprends l'étape 6 sans lui.
8. **Preuves** : pour chaque anomalie, refais les figures qui la montrent, cette fois avec `--sortie` vers le dossier du rapport (§6) :
- un graphique de la série qui la montre le mieux, sur une fenêtre qui laisse voir le niveau habituel autour, l'anomalie grisée (`--zone`), avec au moins un capteur non touché pour comparer ;
- la planche de vignettes, s'il y a des images pendant l'anomalie ;
@@ -87,7 +87,7 @@ Ton enquête est complète ; ton rapport ne garde que ce qui sert la conclusion.
- Un trou n'est pas forcément une coupure : acquisition, traitement, transport et affichage sont des couches distinctes.
- Toute heure est en UTC.
- « Rien d'anormal » est une conclusion valable.
- **Asymétrie** : « Conséquence pour l'ouvrage : aucune » seulement si les trois tiennent : correspondance complète à un cas (étape 5), niveau de preuve au moins `strongly supported`, et un mouvement réel de l'ouvrage écarté par la réfutation (étape 7). Sinon « indéterminée », ou « mouvement réel » si tes preuves l'établissent. Une fausse assurance coûte plus qu'une fausse alerte.
- **Asymétrie** : « Conséquence pour l'ouvrage : aucune » seulement si les trois tiennent : correspondance complète à un event (étape 5), niveau de preuve au moins `strongly supported`, et un mouvement réel de l'ouvrage écarté par la réfutation (étape 7). Sinon « indéterminée », ou « mouvement réel » si tes preuves l'établissent. Une fausse assurance coûte plus qu'une fausse alerte.
- **Écris court.** Des phrases simples ; des chiffres arrondis (deux chiffres significatifs) ; pas de valeurs pas à pas, la figure les montre. Le corps du rapport (jusqu'à « Hors anomalie » compris) tient en 40 lignes environ, figures comprises.
- Lecture seule : tu n'écris que ton rapport et ses figures.
- Rapport en français ; termes AIMsight en anglais (classifications, noms de colonnes).
@@ -102,7 +102,7 @@ Un dossier par rapport : `agent-diagnostic/rapports/<AAAA-MM-JJTHHMMZ>_<STATION>
<dossier> ; mesures du <début> au <fin> (UTC) · <scan | « question »> · <ton modèle> · diagnostic du AAAA-MM-JJ
## Verdict
<2-3 phrases : la station fonctionne-t-elle normalement ? Les anomalies, par importance, une ligne chacune, avec le cas connu qui leur correspond. Ou : aucune anomalie.>
<2-3 phrases : la station fonctionne-t-elle normalement ? Les anomalies, par importance, une ligne chacune, avec l'event connu qui leur correspond. Ou : aucune anomalie.>
## A1 : <titre court> (<début> → <fin> UTC ; <occurrences s'il y en a plusieurs>)
<Constat, 2-3 phrases : quels capteurs, combien de fois leur niveau habituel, combien de temps, retour à la normale ou non ; ce que font les autres capteurs.>
@@ -113,7 +113,7 @@ Un dossier par rapport : `agent-diagnostic/rapports/<AAAA-MM-JJTHHMMZ>_<STATION>
![<ce que montrent les vignettes>](<fichier>.png)
*<Légende, une ligne.>* (Ou, sans image pendant l'anomalie : « Pas d'image pendant l'anomalie. »)
- **Cas connu** : <C-xxx, complète (critères 1 à n vérifiés) | C-xxx, partielle (critère k non vérifiable : <raison>) | aucun cas connu (<cas ouverts, et le critère contredit> | aucun cas proche | index vide)>
- **Event connu** : <E-xxx, complète (critères 1 à n vérifiés) | E-xxx, partielle (critère k non vérifiable : <raison>) | aucun event connu (<cas ouverts, et le critère contredit> | aucun event proche | index vide)>
- **Classification** : <la principale, parmi : *monitored-object motion*, *camera/reference compensation event*, *weak/unstable reference solution*, *model mismatch/parallax*, *target-local degradation*, problème système, indéterminé> · **Niveau de preuve** : … · **Cause probable** : <buée ou eau | occlusion | turbulence | éclairage | inconnue> · **Conséquence pour l'ouvrage** : <aucune | mouvement réel | indéterminée> · **Action** : <aucune | à vérifier | intervention>. Sans cas connu, la ligne commence par « **Non validé (support)** : ».
- **Réfutation** : <le fait cherché pour contredire l'hypothèse principale> → <ce que tu as trouvé>
- **Non établi** : <le principal inconnu, et les alternatives non écartées> ; **à vérifier** : <la vérification la plus discriminante, par un humain ou une donnée à obtenir ; pas de nouveau réglage chiffré sans source>
@@ -136,11 +136,11 @@ Un dossier par rapport : `agent-diagnostic/rapports/<AAAA-MM-JJTHHMMZ>_<STATION>
- **Verdict** : accepté tel quel | corrigé
- **Corrections** :
- **Diagnostic final** :
- **Devient un cas** : oui (C-xxx) | non
- **Devient un event** : oui (E-xxx) | non
```
Sans anomalie : le verdict le dit, et il n'y a pas de section A1.
## 7. Ta réponse
Après avoir écrit le rapport, réponds en 3 à 5 lignes : le verdict, les anomalies (cas connu, classification, niveau de preuve, conséquence pour l'ouvrage), le chemin du rapport.
Après avoir écrit le rapport, réponds en 3 à 5 lignes : le verdict, les anomalies (event connu, classification, niveau de preuve, conséquence pour l'ouvrage), le chemin du rapport.