Files
Support-Agent/.claude/skills/support/rapport.md
T

88 lines
6.2 KiB
Markdown

# 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_a_probleme` (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"
```