Support skill: /support <STATION> writes a situation report from the labeler's labels (labeling/auto/), one or two images per finding (curves of the targets, camera image when the cause shows), one section per slide; /support <mail> unchanged (D-113)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-11-02 17:45:36 +01:00
1 parent 30940e4f50
commit 026a5bd432
4 files changed
+99 -3

No files matched your search

+4 -2
View File
@@ -1,10 +1,12 @@
---
name: support
description: Répondre à la question d'un client sur un système AIMsight — lit le mail (et sa capture), les données locales de data/, répond à la question seule, et rédige un mail prêt à envoyer, avec un GIF des images si utile, dans un dossier de cas support/. Lancé par l'utilisateur, avec /support <mail>.
description: Le support d'un système AIMsight — /support <STATION> fait le rapport de situation de la station à partir de ses étiquettes (labeling/auto/) ; /support <mail> répond à la question d'un client (mail et capture, données de data/) par un mail prêt à envoyer. Dans un dossier de cas support/. Lancé par l'utilisateur.
disable-model-invocation: true
argument-hint: "<mail du client> (capture collée dans le même message)"
argument-hint: "<STATION> [--du AAAA-MM-JJ --au AAAA-MM-JJ] | <mail du client> (capture collée dans le même message)"
---
**L'argument est un nom de station** (un dossier de `labeling/auto/`), seul ou avec `--du --au` : suis `.claude/skills/support/rapport.md`, le rapport de situation, et pas la suite de ce fichier. **Sinon, c'est le mail d'un client** : suis ce qui suit.
# Répondre à un client
Un client écrit au support à propos d'un de ses systèmes, souvent avec une capture de sa plateforme. Tu réponds à **sa question, et seulement à elle** : d'autres systèmes détectent les anomalies (détecteurs du journal, agent de diagnostic, notifications). Tu produis un mail prêt à envoyer, que Marc relit et peaufine avec toi dans cette conversation avant de l'envoyer lui-même. Design : `docs/superpowers/specs/2026-10-28-support-agent-design.md`.
+87
View File
@@ -0,0 +1,87 @@
# Rapport de situation d'une station
`/support <STATION> [--du AAAA-MM-JJ --au AAAA-MM-JJ]` : tu fais le point sur une station, pour le client, **à partir de ses étiquettes** (D-113). Les étiquettes de `labeling/auto/<STATION>.jsonl` (l'`etiqueteur`) disent déjà ce qui s'est passé, quand, sur quelles cibles, pourquoi et ce qu'il faut en conclure : elles font le diagnostic, tu ne le refais pas. Si tu en as besoin (une étiquette floue, une cible à nommer, une contradiction), regarde les données de `data/<STATION>/` sur sa plage, avec les mêmes outils. Tu les rassembles en un diagnostic que le client comprend, appuyé par une ou deux images par constat (§3), et que l'on mettra ensuite en diapositives : une section du rapport, une diapositive. **Concis, simple, clair et précis** : peu de constats, peu de mots, une image qui montre ce que dit la phrase.
Lecture seule : tu n'écris que dans le dossier du rapport (§4) ; tu ne modifies pas les étiquettes. Pour les images, les outils de `.claude/skills/lire-les-donnees/SKILL.md` (mêmes conventions), plus `mkdir`, `cp` et `date`.
## 1. Lire les étiquettes
Une ligne JSON par étiquette : `debut`, `fin` (UTC), `categorie` (la famille), `description`. Lis `labeling/familles.md` (familles, ce qu'elles veulent dire pour le client), puis les étiquettes de la plage :
```bash
python3 -c "import json,sys; [print(json.dumps(l, ensure_ascii=False)) for l in map(json.loads, open('labeling/auto/<STATION>.jsonl')) if l['fin'] >= '<DU>' and l['debut'] <= '<AU>T23:59Z']"
```
Sans `--du --au` : toutes les étiquettes du fichier, et la plage va de la première à la dernière. Pas d'étiquette sur la plage, ou pas de fichier : dis-le à Marc et arrête-toi. Une étiquette sans famille : range-la d'après sa description et la table des familles, et note-le dans la partie interne.
## 2. Comprendre la situation
- **Regroupe** : plusieurs étiquettes d'une même cause (la pluie chaque nuit, le même train, la même cible gênée) font **un** constat, avec ses dates et ses cibles.
- **Classe par ce qui compte pour le client** : `deplacement` (à vérifier), `cible_degradee` (intervenir), `trou` (données absentes), puis `obstruction` et `visibilite` (courbes à ignorer sur leur plage), enfin `deplacement_thermique` (normal).
- **Réponds à trois questions** : l'ouvrage bouge-t-il ? Peut-on croire les courbes, et quand ne le peut-on pas ? Faut-il faire quelque chose, et quoi ?
- Rien au-delà des étiquettes : chaque phrase du rapport vient d'une ou de plusieurs étiquettes, que tu cites dans la partie interne par leur `debut`. Ce que les étiquettes laissent ouvert (« la nature n'est pas établie ») reste ouvert.
## 3. Les images
Une ou deux par constat, pas plus, dans le dossier du rapport (`--sortie support/<dossier>/`) ; aucune pour « En bref », « À faire » et la chronologie. Elles **montrent** ce que disent les étiquettes, elles ne cherchent rien de nouveau :
- **la courbe** : `.venv/bin/python agent-tools/graphique.py data/<STATION>/ --capteurs <cibles du constat et une cible témoin> --colonnes corr_x,corr_y --debut <un peu avant> --fin <un peu après> --zone <debut>/<fin> --sortie support/<dossier>/` ; la plage de l'étiquette grisée, le client voit ce qui bouge et quand ;
- **la cause, si elle se voit** (pluie, buée, animal, train, soleil, cible sale) : l'image entière de la caméra au moment le plus parlant (`ls data/<STATION>/images/ | grep <AAAAMMJJ>T<HHMM>Z`, puis `cp` dans le dossier sous un nom parlant, ex. `pluie_20260810T0200Z.jpg`), ou `vignettes.py` pour une cible petite dans l'image ;
- regarde chaque image avec Read avant de la garder : si elle ne montre pas clairement ce que dit le texte, ne la mets pas ; une image qui contredit l'étiquette va dans « À relire » ;
- pour un constat qui revient (chaque nuit), une seule occurrence, la plus nette.
## 4. Écrire le rapport
`support/<AAAA-MM-JJ>_<STATION>_rapport-situation/rapport.md` (date du jour, `date -u +%F`) :
```markdown
# <STATION> : situation du <début> au <fin>
## En bref
<trois à cinq phrases : l'ouvrage bouge-t-il ; les données sont-elles fiables, sauf quand ; ce qu'il faut faire (ou rien)>
## Ce qui s'est passé
### <constat 1, en quelques mots>
- **Quand** : <dates et heures UTC, ou « chaque nuit du … au … »>
- **Cibles** : <sensor_name, ou toutes>
- **Ce qu'on voit** : <une ou deux phrases>
- **Ce qu'il faut en conclure** : <ignorer la courbe sur la plage / normal / à vérifier / intervenir>
![<ce que montre l'image, en une phrase>](<fichier>)
### <constat 2> …
## À faire
- <action, cible, pourquoi> (ou « rien : … »)
## Ce qui n'est pas établi
- <ce que les étiquettes laissent ouvert> (ou « rien »)
## Chronologie
| Début (UTC) | Fin (UTC) | Famille | Cibles | Conclusion |
|---|---|---|---|---|
<une ligne par étiquette, dans l'ordre>
---
## Pour le support (interne)
- **Étiquettes** : <fichier, nombre, plage, nombre par famille>
- **Sources** : <constat → `debut` des étiquettes qui le fondent>
- **À relire** : <étiquette rangée par toi, contradiction entre deux étiquettes, doute> (ou « rien »)
```
Pour le client, tout ce qui est au-dessus du trait :
- en français, en mots simples ; « on voit clairement », « c'est compatible avec », « on ne peut pas l'affirmer », jamais le vocabulaire de preuve en anglais ;
- les familles par leur sens (« la visibilité baisse », « un objet cache la cible »), pas par leur clé ;
- heures en UTC, dites ;
- une mesure rejetée n'est pas retirée : « nous jugeons ces mesures peu fiables, mais elles vous sont livrées » ;
- jamais d'interne : codes d'events (E-xxx), noms des détecteurs, des outils ou des agents, autres stations, identifiants (`SIM_CCID`, `ip`) ;
- au plus quatre ou cinq constats, une à trois lignes chacun : le reste va dans la chronologie ;
- sous chaque image, une phrase qui dit ce qu'on y voit (« la plage grisée : la pluie, les courbes s'agitent »).
## 5. Montrer
Dans ta réponse : « En bref » et « À faire » tels quels, le chemin du rapport, les images par `SendUserFile`, et ce qu'il y a « À relire ». Marc relit et corrige avec toi ; tu modifies `rapport.md` à chaque retour. Quand il dit que c'est bon :
```bash
git add support/<dossier>
git commit -m "Support: <STATION>, rapport de situation"
```
+1 -1
View File
@@ -13,7 +13,7 @@ Cadrage du product owner : sous-projet G, santé des sites et notifications au c
- **Domaines système, livrés en prototype** : Energy (D-020, D-043), Storage (D-034, D-035), Cellular (D-031, D-037), Temperature (D-040) ; chacun avec ses analyses, sa couleur du jour, sa figure du site, son bloc dans la vue client, sa notification support et son guide (D-039, D-041). Seul Energy repose sur des events de l'expert ; les autres ont des seuils provisoires et attendent le spécialiste.
- **Maquettes du site** (D-022, D-039) : client « System Summary », une page par station, un bloc par domaine ; support « Home », une notification par station et par domaine Orange ou Red, liée à la vue client (D-025).
- **Déplacements, le cap actuel : le journal du matin** (D-056). Une anomalie de déplacement est ce qui rend les courbes non plates : presque toujours un moment où il ne faut pas se fier aux données (pluie, buée, train, toile d'araignée, turbulence…), parfois un vrai mouvement (E-004, incident de Barcelone). Détecteurs élémentaires classés par catégorie (D-074), onglet `Journal` de la maquette Explore, amélioration par `/events-learner` (D-057), base d'events `events/` revue par `/review-event` (D-075). `/events-learner` sur les étiquettes (D-112) : l'`etiqueteur` étiquette le lot en amont (`labeling/auto/`), puis le `detectors-critic` juge les détecteurs face à ses étiquettes, par famille, le `detectors-upgrader` les adapte, le `detectors-control` garde la base d'events ; l'analyste, le `tool-builder` et l'`event-builder` (D-088 à D-092, D-097) sont hors de la séance ; la carte des événements apprend de chaque event validé (D-087). Tout le suivi est dans le plan vivant `docs/superpowers/plans/2026-10-23-journal-du-matin.md`.
- **Support** (D-079) : `/support <mail>` répond à la question d'un client, et à elle seule. Premier cas : LENZSPITZE, nuit du 26 au 27.10.
- **Support** (D-079, D-113) : `/support <mail>` répond à la question d'un client, et à elle seule (premier cas : LENZSPITZE, nuit du 26 au 27.10) ; `/support <STATION>` fait le rapport de situation de la station à partir de ses étiquettes (`labeling/auto/`), appuyé d'images, à mettre ensuite en présentation.
- **Agent de diagnostic** (D-046, D-058, D-082) : gardé dans le doute, pour un cas que les détecteurs n'expliquent pas.
- **En attente** : agents LLM côté serveur (D-027) et enquête par API (D-042), documents seulement ; communication avec la caméra (dev container, D-038), en attente de la doc de l'API REST ; détection des sauts et tendances (D-055, onglet `Displacements`), très expérimentale.
- **Prochaine étape** :
+7
View File
@@ -1072,3 +1072,10 @@ Règles du journal :
- **Pourquoi** : l'utilisateur, 2026-11-02 : le travail de l'analyste est fait en amont, dans `labeling/auto/`, avec les étiquettes ; adapter le processus pour les utiliser. Le `tool-builder` et l'`event-builder` lisaient l'analyse de la séance : sans elle, ils n'ont plus d'entrée (avis de Claude, le plus simple).
- **Options écartées** : convertir les étiquettes au format de l'analyste (`etiquettes.json`, capteurs, catégories du journal) : une famille couvre plusieurs catégories, et les capteurs ne sont que dans le texte ; un score par capteur, tiré des noms de la description (fragile) ; un score sur tous les lots étiquetés de la station (le fichier ne dit pas quelles plages l'étiqueteur a lues en entier) ; garder l'ancienne page des séances passées (`lot-*/etiquettes.json`).
- **Conséquence** : `analyste`, `tool-builder` et `event-builder` restent, sans appel par la séance ; la base d'events ne grandit plus par `/events-learner`. Les séances passées gardent leurs fichiers, leur page ne se refait plus avec ce `comparaison.py`. Les 7 étiquettes du premier essai de JUNGFRAU (20 → 25.10) n'ont pas de famille : le score les compte « sans famille ».
## D-113 — 2026-11-02 — `/support <STATION>` : le rapport de situation, à partir des étiquettes
- **Statut** : active, à essayer ; complète D-079, qui reste le mode « mail ».
- **Décision** : `/support <STATION> [--du --au]` (`.claude/skills/support/rapport.md`) fait le point sur une station pour le client, à partir des étiquettes de `labeling/auto/<STATION>.jsonl` et de `labeling/familles.md`, qui font le diagnostic ; les données de `data/` ne servent qu'à l'illustrer, une ou deux images par constat (la courbe des cibles touchées, plage grisée, et l'image de la caméra quand la cause s'y voit), chacune regardée avant d'être gardée. Il regroupe les étiquettes d'une même cause en constats, les classe par ce qui compte pour le client (Displacement, Faulty target, No data, puis Obstruction et Visibility, enfin Thermal displacement), et écrit `support/<AAAA-MM-JJ>_<STATION>_rapport-situation/rapport.md` : En bref, Ce qui s'est passé, À faire, Ce qui n'est pas établi, Chronologie, puis une partie interne (sources par `debut` d'étiquette, points à relire). Une section, une diapositive : les rapports seront mis en présentation ensuite. `/support <mail>` ne change pas.
- **Pourquoi** : l'utilisateur, 2026-11-02 : l'agent de support produit un rapport de situation, un diagnostic fondé sur les étiquettes ; elles lui donnent tout ce qu'il faut pour comprendre ce qui ne va pas et répondre au client. Premier usage : trois stations étiquetées par l'`etiqueteur`, rapports à mettre en PowerPoint. Puis : des images pour appuyer ce qui est dit, dans le rapport et la présentation, mais un résultat concis, simple, clair et précis.
- **Options écartées** : remplacer le mode mail (validé sur LENZSPITZE) ; un sous-agent à part (le rapport se relit et se corrige dans la conversation, comme le mail) ; relire les données pour refaire ou vérifier le diagnostic (c'est le travail de l'étiqueteur et de la relecture de l'utilisateur) ; plusieurs figures par constat (concision).
- **Conséquence** : la qualité du rapport est celle des étiquettes ; une étiquette sans famille est rangée par l'agent et signalée « à relire ».