6.9 KiB
name, description, disable-model-invocation, argument-hint
| name | description | disable-model-invocation | argument-hint |
|---|---|---|---|
| support | 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>. | true | <mail du client> (capture collée dans le même message) |
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.
Lecture seule : tu n'écris que dans le dossier du cas (§3). Tu ne télécharges aucune donnée, tu n'ajoutes rien à la base de cas, tu ne modifies ni détecteur ni outil.
Commandes : celles de .claude/skills/lire-les-donnees/SKILL.md (mêmes conventions : une commande par appel, depuis la racine du dépôt), plus python3 vues-deplacements/detectors/categories.py <dossier>, gif.py (§4), mkdir, cp (la capture), date, et à la fin git add/git commit du seul dossier du cas.
1. Comprendre la demande
Tire du mail et de la capture :
- la station : la plateforme du client a souvent ses propres noms (séries, « Installation 2 ») ; ce sont les mêmes données qu'AIMsight, pas forcément traitées de la même façon. Un nom du mail ou de la capture qui désigne sans doute un dossier de
data/suffit : cite-le. Sinon, demande à Marc ; - la plage : d'après le mail (« cette nuit ») et l'axe de la capture, qui peut être en heure locale ;
- la question, reformulée en une phrase ;
- les séries concernées : la correspondance entre les noms du client et les
sensor_namede l'export, si tu peux l'établir (positions, nombre de cibles) ; sinon, tous les capteurs, et tu le notes.
S'il te manque la station, ou une plage qui reste ambiguë, demande-le à Marc en un seul message, et arrête-toi là jusqu'à sa réponse.
2. Vérifier les données
python3 agents/diagnostic/outils/inventaire.py data/<STATION>/ --debut T --fin T. S'il manque les déplacements ou les images de la plage, dis à Marc ce qui manque (dates, type) et arrête-toi : c'est lui qui pompe (run.md).
3. Le dossier du cas
support/<AAAA-MM-JJ>_<STATION>_<sujet>/ (date du jour, date -u +%F ; sujet en 2-3 mots, ex. activite-voies). Écris d'abord demande.md :
# <STATION> : <sujet>
- **Statut** : brouillon
- **Reçu le** : AAAA-MM-JJ
- **Station** : <STATION>, <déduite de … | donnée par Marc>
- **Plage** : <début> → <fin> UTC (<d'où elle vient : mail, axe de la capture>)
- **Question** : <la question reformulée>
- **Séries** : <correspondance client → sensor_name, ou « non établie »>
## Mail du client
<le mail, tel quel>

La capture : une image collée apparaît dans le message comme [Image: source: <chemin>] ; cp <chemin> support/<dossier>/capture.png. Sans chemin, remplace la ligne par une description de la capture.
4. Enquêter sur la question
Lis .claude/skills/lire-les-donnees/SKILL.md, puis suis agents/diagnostic/instructions.md, §4 étapes 2, 4, 5 et 7 (repérage avec categories.py, faits, cas connus après les faits, réfutation) et §5 (règles), limités à la plage et à ce qu'il faut pour répondre. Figures avec --sortie support/<dossier>/.
- Situe ce dont parle le client : quand, quels capteurs, cibles ou références, et ce que font les autres capteurs (ex. une autre mesure du client, ici le théodolite, qui reste plate).
- Regarde les images entières (Read) aux moments en question, plus une avant et une après ;
vignettes.pypour les cibles touchées et un témoin. - Dis ce que la cadence des images ne permet pas d'établir : des images horaires peuvent manquer un train qui passe en une minute ; une image sans train ne prouve pas qu'aucun train n'est passé.
- Le GIF, s'il prouve mieux qu'une phrase (un passage, de la buée qui se lève) :
.venv/bin/python agents/diagnostic/outils/gif.py data/<STATION>/ --debut T --fin T --sortie support/<dossier>/(720 px, 64 teintes, heure UTC en bas à droite ; ~3 Mo par nuit d'images horaires). Garde-le sous ~5 Mo (pièce jointe) : resserre la plage ou--largeur. Regarde quelques-unes de ses images sources avec Read avant de le joindre.
5. Écrire
analyse.md, pour Marc et la documentation : la question ; les faits qui fondent la réponse (heures UTC, capteurs, ce que montrent les images), chacun avec sa commande ; le cas connu s'il y en a un ; la réfutation ; ce qui reste non établi ; les figures. Vocabulaire de preuve du projet (confirmed … not observed). Puis :
## Hors question (pour Marc)
- <ce que tu as vu sans que le client l'ait demandé ; quelques lignes au plus, ou « rien »>
reponse.md, le mail au client :
**Objet** : Re: <objet ou sujet>
<corps>
**Pièces jointes** : <fichier.gif — ce qu'on y voit> (ou « aucune »)
Le corps :
- d'abord la réponse, en une ou deux phrases : oui, non, ou les images ne permettent pas de le dire, et pourquoi ;
- puis les quelques éléments que le client peut reprendre dans son rapport : heures, cibles, ce que montrent les images, le GIF joint ;
- honnête sur ce qui n'est pas établi, en mots simples (« on voit clairement », « c'est compatible avec », « on ne peut pas l'affirmer ») ;
- rien hors de la question ; seule exception, un fait qui change la réponse elle-même (« ce n'est pas un mouvement de l'ouvrage : le théodolite ne bouge pas ») ;
- les cibles par leur
sensor_namededata/(ex.101B), suivi du nom du client entre parenthèses seulement si la correspondance est établie ; - heures en UTC, dites ; l'heure locale entre parenthèses si la capture du client est visiblement en heure locale ;
- dans la langue et sur le ton du client (tutoiement s'il tutoie), signé du prénom par lequel il s'adresse au support ;
- jamais d'interne : codes de cas (C-xxx), noms des détecteurs ou des outils, autres stations, identifiants (
SIM_CCID,ip), vocabulaire de preuve en anglais.
6. Montrer
Dans ta réponse : le mail en entier, tel qu'il est dans reponse.md ; le GIF par SendUserFile (sans cet outil : son chemin) ; en 2-3 lignes, ce que tu as noté hors question. Puis attends le retour de Marc.
7. Peaufiner
À chaque retour de Marc, modifie reponse.md (et analyse.md ou le GIF si le fond change), puis remontre le mail. Quand Marc dit que c'est bon : Statut : prêt à envoyer dans demande.md, puis
git add support/<dossier>
git commit -m "Support: <STATION>, <sujet>"