Files
Support-Agent/agent-diagnostic/README.md
T

31 lines
3.1 KiB
Markdown
Raw Normal View History

# 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 d'events. 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.md` est chargé (`omitClaudeMd` ne 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 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 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 event
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 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
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.