Events: read-event skill to consult the base (D-085), cases renamed events E-xxx (D-086)
- read-event: map and index first, then the card of close events only, then their data with the reading tools; never all cards at once. Diagnostic agent, critiquer-lot and builder point to it; the index header too. Signature length: about 250 characters, a guideline. - "Cas" becomes "event": events/E-xxx/event.md, skills new-event, review-event, anonymize-event. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
4d99585474
commit
446fde3192
1206 files changed
+2172
-2129
No files matched your search
@@ -19,20 +19,20 @@ Certains clients ont leur propre plateforme qui intègre les données AIMsight :
|
||||
**Objectifs**
|
||||
- Répondre à la question posée par le client, et seulement à elle.
|
||||
- Une réponse juste et prouvée : chaque affirmation du mail repose sur un fait vu dans les données ou les images.
|
||||
- Un dossier par demande, qui documente le cas de support et sert de brouillon pendant le peaufinage.
|
||||
- Un dossier par demande, qui documente l'event de support et sert de brouillon pendant le peaufinage.
|
||||
- Un GIF des images quand il prouve mieux qu'une phrase (ex. un train devant les cibles, de la buée qui se lève).
|
||||
|
||||
**Non-objectifs**
|
||||
- Détecter les anomalies de la station : d'autres systèmes le font (détecteurs du journal, agent de diagnostic, notifications).
|
||||
- Envoyer le mail : Marc l'envoie lui-même.
|
||||
- Télécharger des données : le pompage (`extraction/pomper.py`) reste lancé par l'utilisateur seul.
|
||||
- Ajouter un cas à la base de cas (`agents/diagnostic/cas/`) : cela reste `/nouveau-cas`, lancé par l'utilisateur.
|
||||
- Ajouter un event à la base d'events (`events/`) : cela reste `/new-event`, lancé par l'utilisateur.
|
||||
- Modifier les détecteurs, les outils de lecture ou la connaissance du projet.
|
||||
|
||||
**Anti-objectifs** : un échec, même si l'agent tourne.
|
||||
- Le mail parle d'autre chose que de la question : une cible qui dérive, des références instables, un problème d'énergie. Ces constats vont dans la note pour Marc, jamais dans le mail.
|
||||
- Le mail affirme une cause que les images ne montrent pas, par exemple « un train est passé » alors qu'aucune image ne le montre.
|
||||
- Le mail laisse fuir de l'interne : codes de cas (C-xxx), noms des détecteurs, autres stations, identifiants (`SIM_CCID`, `ip`), vocabulaire de preuve en anglais.
|
||||
- Le mail laisse fuir de l'interne : codes d'events (E-xxx), noms des détecteurs, autres stations, identifiants (`SIM_CCID`, `ip`), vocabulaire de preuve en anglais.
|
||||
|
||||
## 3. Le fonctionnement
|
||||
|
||||
@@ -50,11 +50,11 @@ Appel : `/support <mail du client>`, la capture d'écran collée dans le même m
|
||||
- **la question** : reformulée en une phrase (ex. « Les images montrent-elles de l'activité sur les voies pendant les perturbations de la nuit du 26 au 27.10 ? »).
|
||||
- **les séries concernées** : la correspondance entre les noms de la plateforme du client et les capteurs de l'export, si l'agent peut l'établir. Sinon, il travaille sur tous les capteurs et le note. **Dans le mail, les cibles portent leur nom dans `data/`** (`sensor_name` de l'export, ex. `101B`), décision de l'utilisateur ; le nom de la plateforme du client s'ajoute seulement si la correspondance est établie.
|
||||
2. **Vérifier les données** : `inventaire.py` sur `data/<STATION>/` pour la plage. Si les déplacements ou les images de la plage manquent, l'agent **le dit à Marc et s'arrête** (il ne pompe rien lui-même). Exemple : LENZSPITZE n'a pas de déplacements les 24 et 25.10.
|
||||
3. **Créer le dossier** du cas (§4) et y écrire `demande.md`.
|
||||
3. **Créer le dossier** de l'event (§4) et y écrire `demande.md`.
|
||||
4. **Enquêter sur la question** avec les outils existants (§5) :
|
||||
- situer les perturbations : quand, quels capteurs (détecteurs `categories.py` comme premier repérage, puis `graphique.py`, `plages.py`, `ensemble.py`) ;
|
||||
- regarder les images à ces moments-là, plus une image avant et une après pour comparer (images entières pour la scène, `vignettes.py` pour les cibles) ;
|
||||
- confronter aux cas de la base, après les faits, comme le fait l'agent de diagnostic (§4, étape 5 de `agents/diagnostic/instructions.md`) ;
|
||||
- confronter aux events de la base, après les faits, comme le fait l'agent de diagnostic (§4, étape 5 de `agents/diagnostic/instructions.md`) ;
|
||||
- chercher le fait qui contredirait la réponse envisagée (la réfutation de l'agent de diagnostic, étape 7).
|
||||
5. **Écrire** `analyse.md`, puis `reponse.md`, et faire le GIF s'il sert la réponse (§6).
|
||||
6. **Montrer** à Marc, dans la conversation, le mail en entier, le GIF (`SendUserFile` dans l'application de bureau ; ailleurs, son chemin, choix du builder) et, en deux ou trois lignes, ce qu'il a noté hors question.
|
||||
@@ -70,18 +70,18 @@ Appel : `/support <mail du client>`, la capture d'écran collée dans le même m
|
||||
- Heures en UTC, dites explicitement. Si la capture du client montre visiblement l'heure locale, le mail donne aussi l'heure locale entre parenthèses.
|
||||
- Le vocabulaire de preuve du projet (`confirmed`, `consistent with`…) reste dans `analyse.md`. Le mail le traduit en mots simples (« on voit clairement », « c'est compatible avec », « on ne peut pas l'affirmer »).
|
||||
|
||||
## 4. Le dossier du cas
|
||||
## 4. Le dossier de l'event
|
||||
|
||||
`support/<AAAA-MM-JJ>_<STATION>_<sujet>/` à la racine du dépôt (date du jour en UTC, sujet en 2 ou 3 mots, ex. `support/2026-10-28_LENZSPITZE_activite-voies/`). Il contient :
|
||||
|
||||
| Fichier | Pour qui | Contenu |
|
||||
|---|---|---|
|
||||
| `demande.md` | Marc, la documentation | Le mail du client tel quel ; la capture, copiée dans le dossier (`capture.png`) depuis le chemin que Claude Code donne pour une image collée (`[Image: source: …/images/N.png]`) ; sans chemin, une description de la capture (choix du builder) ; la station et comment elle a été établie (déduite ou donnée par Marc) ; la plage et la question reformulées ; le statut (`brouillon` / `prêt à envoyer`) |
|
||||
| `analyse.md` | Marc, la documentation | Les faits qui fondent la réponse, traçables (commandes, heures en UTC, capteurs), le cas connu s'il y en a un, la réfutation, ce qui reste non établi ; puis **« Hors question (pour Marc) »** : ce que l'agent a vu sans que le client l'ait demandé, quelques lignes au plus |
|
||||
| `analyse.md` | Marc, la documentation | Les faits qui fondent la réponse, traçables (commandes, heures en UTC, capteurs), l'event connu s'il y en a un, la réfutation, ce qui reste non établi ; puis **« Hors question (pour Marc) »** : ce que l'agent a vu sans que le client l'ait demandé, quelques lignes au plus |
|
||||
| `reponse.md` | le client | Le mail prêt à copier : objet, corps, pièces jointes |
|
||||
| `*.gif`, `*.png` | le client ou Marc | Le GIF et les figures qui servent la réponse ou l'analyse |
|
||||
|
||||
`support/` est **versionné dans git** (décision de l'utilisateur) : les dossiers forment peu à peu une base de cas de support, utile pour l'historique (son usage sera rediscuté). Il contient donc des mails et des images de clients, contrairement à `data/` (D-065) et à la base de cas anonymisée.
|
||||
`support/` est **versionné dans git** (décision de l'utilisateur) : les dossiers forment peu à peu une base d'events de support, utile pour l'historique (son usage sera rediscuté). Il contient donc des mails et des images de clients, contrairement à `data/` (D-065) et à la base d'events anonymisée.
|
||||
|
||||
## 5. Ce qu'il réutilise
|
||||
|
||||
@@ -89,8 +89,8 @@ Tout ce que le projet a déjà construit pour lire les déplacements :
|
||||
- le skill `lire-les-donnees` (`.claude/skills/lire-les-donnees/SKILL.md`) : ses outils (`agents/diagnostic/outils/`) et sa méthode de lecture ;
|
||||
- les détecteurs du journal du matin : `python3 vues-deplacements/detectors/categories.py <dossier>` (catégories : visibilité, sauts, thermique, turbulence…), comme premier repérage ;
|
||||
- la connaissance du projet : `docs/domaine/`, `docs/displacement/` (dont `domaine/carte-des-evenements.md`), la doc AIMsight (`docs/aimsight/`, par section) ;
|
||||
- la base de cas `agents/diagnostic/cas/` (`INDEX.md`, puis les fiches) ;
|
||||
- le déroulé et les règles de l'agent de diagnostic (`agents/diagnostic/instructions.md`, §4 et §5) : faits, cas connus après les faits, réfutation, vocabulaire de preuve, asymétrie. Le skill les cite au lieu de les recopier.
|
||||
- la base d'events `events/` (`INDEX.md`, puis les fiches) ;
|
||||
- le déroulé et les règles de l'agent de diagnostic (`agents/diagnostic/instructions.md`, §4 et §5) : faits, events connus après les faits, réfutation, vocabulaire de preuve, asymétrie. Le skill les cite au lieu de les recopier.
|
||||
|
||||
À la différence de l'agent de diagnostic, il n'est pas « à l'aveugle » : il tourne dans la conversation principale, avec `CLAUDE.md` chargé, et peut lire ce qui l'aide.
|
||||
|
||||
@@ -115,11 +115,11 @@ Cadence observée : LENZSPITZE a une image par heure, donc une nuit fait une diz
|
||||
- Règles non négociables du projet : traçabilité, heures en UTC, ne pas confondre « pas de donnée » et « station arrêtée », pas de chiffre sans source.
|
||||
- Ne pas recopier d'identifiants (`SIM_CCID`, `ip`) dans le dossier.
|
||||
- Pas de LLM ajouté au code : seul le skill (Claude Code) raisonne, et les outils restent des scripts.
|
||||
- Processus léger (phase expérimentale) : pas de tests automatisés (D-008). La vérification se fait sur le cas réel (§8).
|
||||
- Processus léger (phase expérimentale) : pas de tests automatisés (D-008). La vérification se fait sur l'event réel (§8).
|
||||
|
||||
## 8. Vérification
|
||||
|
||||
Le cas de l'exemple : `/support` avec le mail et la capture ci-dessus, la station LENZSPITZE donnée par Marc quand l'agent la demande. Attendu : le dossier `support/2026-10-28_LENZSPITZE_…/` complet, un mail qui répond à « y a-t-il eu de l'activité sur les voies ? » pour la nuit du 26 au 27.10 et dit ce que les images horaires ne permettent pas d'établir, un GIF de la nuit, puis au moins une boucle de peaufinage sur un retour de Marc.
|
||||
L'event de l'exemple : `/support` avec le mail et la capture ci-dessus, la station LENZSPITZE donnée par Marc quand l'agent la demande. Attendu : le dossier `support/2026-10-28_LENZSPITZE_…/` complet, un mail qui répond à « y a-t-il eu de l'activité sur les voies ? » pour la nuit du 26 au 27.10 et dit ce que les images horaires ne permettent pas d'établir, un GIF de la nuit, puis au moins une boucle de peaufinage sur un retour de Marc.
|
||||
|
||||
## 9. Laissé au builder
|
||||
|
||||
@@ -129,8 +129,8 @@ Le cas de l'exemple : `/support` avec le mail et la capture ci-dessus, la statio
|
||||
|
||||
## Annexe : pistes à revoir (pas dans le socle)
|
||||
|
||||
- L'usage de la base de cas de support (`support/`) : à rediscuter avec l'utilisateur.
|
||||
- L'usage de la base d'events de support (`support/`) : à rediscuter avec l'utilisateur.
|
||||
- Recadrer le GIF sur une zone ou sur des capteurs (comme `vignettes.py`), si l'image entière ne suffit pas.
|
||||
- Lire directement un mail exporté (`.eml`) plutôt qu'un texte collé.
|
||||
- Une table des correspondances client → station (noms de plateforme, « Installation 2 »), si les mêmes clients reviennent.
|
||||
- Proposer à Marc de transformer un cas de support en cas de la base (`/nouveau-cas`), quand l'explication est validée.
|
||||
- Proposer à Marc de transformer un cas de support en event de la base (`/new-event`), quand l'explication est validée.
|
||||
Reference in new issue
Block a user