Support-agent: /support skill answers a client's question, GIF tool, first case LENZSPITZE (draft)
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
425acbbad4
commit
02f2bf5369
12 files changed
+505
-3
No files matched your search
@@ -0,0 +1,101 @@
|
||||
---
|
||||
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>.
|
||||
disable-model-invocation: true
|
||||
argument-hint: "<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_name` de 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` :
|
||||
|
||||
```markdown
|
||||
# <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.py` pour 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 :
|
||||
|
||||
```markdown
|
||||
## 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 :
|
||||
|
||||
```markdown
|
||||
**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_name` de `data/` (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
|
||||
|
||||
```bash
|
||||
git add support/<dossier>
|
||||
git commit -m "Support: <STATION>, <sujet>"
|
||||
```
|
||||
Reference in new issue
Block a user