Add the empty case base and the known-cases step to the diagnostic agent (D-048)
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
2a39335fb5
commit
f056da2875
2 files changed
+32
-8
No files matched your search
@@ -0,0 +1,8 @@
|
||||
# Cas connus
|
||||
|
||||
Incidents validés par l'expert, un par ligne. La **Signature** résume ce qu'on observe : type de capteurs, combien, colonne, forme, moment, durée, retour à la normale. Ouvre la fiche d'un cas proche par son lien ; ses critères et ses exclusions se vérifient avec tes outils, sur tes données.
|
||||
|
||||
| Cas | Station · fenêtre (UTC) | Signature | Classification | Cause (expert) | Verdict expert |
|
||||
|---|---|---|---|---|---|
|
||||
|
||||
*Base vide pour l'instant.*
|
||||
@@ -20,10 +20,11 @@ Seulement :
|
||||
- `docs/aimsight/AIMsight_agentic_support_project_context.md`, sections 4 (chaîne de dépendance), 12 (familles d'hypothèses) et 13 (*support query workflow*) ;
|
||||
- `docs/aimsight/AIMsight_reference_quality_event_explainer_roadmap.md`, section 4.3 (classifications) ;
|
||||
- `docs/aimsight/AIMsight FAQ.pdf`, pour `error` : `pdftotext -layout "docs/aimsight/AIMsight FAQ.pdf" - | grep -n -i -B2 -A12 'error value'`.
|
||||
- à l'étape 5 du déroulé (§4) seulement, jamais avant : `agents/diagnostic/cas/INDEX.md`, puis les fiches `cas.md` qu'il cite et leurs figures. Ce sont des incidents validés par l'expert.
|
||||
|
||||
Pour un long fichier AIMsight, trouve la section avec `grep -n '^#' <fichier>`, puis lis-la seule (Read avec `offset` et `limit`).
|
||||
|
||||
**Ne lis rien d'autre** : ni `CLAUDE.md`, ni `docs/decisions.md`, ni les autres documents du projet, ni les rapports de `agents/diagnostic/rapports/`. Ils peuvent contenir des conclusions sur ces données ; ton diagnostic doit partir des données. Tu listes dans ton rapport tout ce que tu as lu. Si l'environnement t'a fourni un contexte que tu n'as pas ouvert (ex. `CLAUDE.md`), signale-le dans « Sources lues » et ne t'en sers pas.
|
||||
**Ne lis rien d'autre** : ni `CLAUDE.md`, ni `docs/decisions.md`, ni les autres documents du projet, ni les rapports de `agents/diagnostic/rapports/`, ni une fiche de `agents/diagnostic/cas/` que l'index ne cite pas. Ils peuvent contenir des conclusions sur ces données ; ton diagnostic doit partir des données. Tu listes dans ton rapport tout ce que tu as lu. Si l'environnement t'a fourni un contexte que tu n'as pas ouvert (ex. `CLAUDE.md`), signale-le dans « Sources lues » et ne t'en sers pas.
|
||||
|
||||
|
||||
## 3. Tes outils
|
||||
@@ -61,13 +62,25 @@ Ton enquête est complète ; ton rapport ne garde que ce qui sert la conclusion.
|
||||
- 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. **Hypothèses** : prends-les dans les familles de la section 12 du contexte support, plus le mouvement réel de l'ouvrage. Pour chacune, ce qui la soutient et ce qui la contredit.
|
||||
6. **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 ?
|
||||
7. **Preuves** : pour chaque anomalie, refais les figures qui la montrent, cette fois avec `--sortie` vers le dossier du rapport (§6) :
|
||||
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 `agents/diagnostic/cas/INDEX.md`. Pour chaque anomalie, choisis au plus 3 cas dont la signature est proche de tes faits et ouvre leurs fiches.
|
||||
- Vérifie chaque critère de la signature et chaque exclusion de la fiche sur **tes** données, avec tes outils : vérifié, contredit ou non vérifiable (donnée absente).
|
||||
- Conclus, par anomalie :
|
||||
|
||||
| Correspondance | Quand | Suite |
|
||||
|---|---|---|
|
||||
| **complète** | tous les critères vérifiés, aucune exclusion observée | le diagnostic de l'expert (classification, cause, conséquence, action) est ton hypothèse principale |
|
||||
| **partielle** | aucun critère contredit, certains 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 une exclusion observée ; ou index vide | tes propres hypothèses (étape 6), marquées « Non validé (support) » ; conséquence « indéterminée » |
|
||||
|
||||
- Si deux cas correspondent, garde celui qui a le plus de critères vérifiés et cite l'autre.
|
||||
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 les familles de la section 12 du contexte support, plus le mouvement réel de l'ouvrage. Pour chacune, ce qui la soutient et ce qui la contredit.
|
||||
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 ?
|
||||
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 ;
|
||||
- deux ou trois figures au plus par anomalie. Regarde chacune (Read) : une figure qui ne montre pas clairement le constat ne va pas dans le rapport.
|
||||
8. **Rapport** (§6), puis ta réponse (§7).
|
||||
9. **Rapport** (§6), puis ta réponse (§7).
|
||||
|
||||
## 5. Règles
|
||||
|
||||
@@ -78,6 +91,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 avec une correspondance complète à un cas (étape 5). 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).
|
||||
@@ -92,7 +106,7 @@ Un dossier par rapport : `agents/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. Ou : aucune anomalie.>
|
||||
<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.>
|
||||
|
||||
## 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.>
|
||||
@@ -103,7 +117,8 @@ Un dossier par rapport : `agents/diagnostic/rapports/<AAAA-MM-JJTHHMMZ>_<STATION
|
||||

|
||||
*<Légende, une ligne.>* (Ou, sans image pendant l'anomalie : « Pas d'image pendant l'anomalie. »)
|
||||
|
||||
- **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>
|
||||
- **Cas connu** : <C-xxx, complète (critères 1 à n vérifiés, aucune exclusion) | C-xxx, partielle (critère k non vérifiable : <raison>) | aucun cas connu (<cas ouverts et critère contredit> ou 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>
|
||||
|
||||
@@ -125,10 +140,11 @@ Un dossier par rapport : `agents/diagnostic/rapports/<AAAA-MM-JJTHHMMZ>_<STATION
|
||||
- **Verdict** : accepté tel quel | corrigé
|
||||
- **Corrections** :
|
||||
- **Diagnostic final** :
|
||||
- **Devient un cas** : oui (C-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 (classification, niveau de preuve), le chemin du rapport.
|
||||
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.
|
||||
Reference in new issue
Block a user