3.6 KiB
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. Pilote de l'enquête à la demande (D-042) ; décision D-046 ; spec : docs/agents/agent-diagnostic.md.
L'appeler
- Dans une session Claude Code :
@agent-diagnostic data/PS_DES_COUDRES/, suivi au besoin d'une question (« que s'est-il passé dans la nuit du 13 au 14/10 ? »). Sans question, il fait le scan de toute la période. - Ne lui passer que le dossier et la question : le sous-agent ne voit pas la conversation, seulement ce qu'on lui transmet.
- Dans un terminal, une session entière avec l'agent :
claude --agent diagnostic. Attention : en session principale,CLAUDE.mdest chargé (omitClaudeMdne vaut que pour un sous-agent) ; l'agent connaît alors nos conclusions. - Les sous-agents se chargent au démarrage d'une session : après une modification de
.claude/agents/diagnostic.md, ouvrir une nouvelle session.
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).
Contenu du dossier
instructions.md: sa méthode, ses règles et le format du rapport. C'est ici qu'on corrige son comportement.outils/:inventaire.py,resume.py,graphique.py,vignettes.py(recadrage des images autour des capteurs), etdonnees.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.cas/: la base de cas validés par l'expert (D-048) :INDEX.md, une ligne par incident, et un dossier par incident (cas.mdet ses figures). L'agent la lit après avoir établi ses faits. Spec : §11 dedocs/agents/agent-diagnostic.md.
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.
- Les données vont dans
data/<STATION>/(D-029) ; l'avis de l'expert reste hors du dépôt jusqu'à l'étape 4. - Commiter (arbre propre : un
git statussale 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. - Comparer son rapport à l'avis de l'expert ; un attendu manqué se corrige dans
instructions.md. - Écrire
cas/C-<numéro>_<STATION>_<AAAA-MM-JJ>/cas.mdau 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.
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).
Limites
Claude Code ne restreint ni ce qu'il lit, ni ce que lance son Bash, ni où écrit son Write : ses instructions le font. Son rapport liste ce qu'il a lu.