From 22afd57b55d96c0b25f440d3d7162e4e92086648 Mon Sep 17 00:00:00 2001 From: maxime Date: Tue, 13 Oct 2026 09:39:13 +0200 Subject: [PATCH] Add the nouveau-domaine skill to add a notification domain Co-Authored-By: Claude Opus 5.5 --- .claude/skills/nouveau-domaine/SKILL.md | 55 ++++++++++++++++++++++++ .claude/skills/nouvelle-analyse/SKILL.md | 6 +-- 2 files changed, 58 insertions(+), 3 deletions(-) create mode 100644 .claude/skills/nouveau-domaine/SKILL.md diff --git a/.claude/skills/nouveau-domaine/SKILL.md b/.claude/skills/nouveau-domaine/SKILL.md new file mode 100644 index 0000000..903eb53 --- /dev/null +++ b/.claude/skills/nouveau-domaine/SKILL.md @@ -0,0 +1,55 @@ +--- +name: nouveau-domaine +description: Ajouter un domaine de diagnostic, donc une nouvelle notification, au projet AIMsight (ex. espace disque, signal 4G, températures) — données reçues, exploration, cas experts, analyses, verdict du jour, livraison. À utiliser dès que l'utilisateur apporte les données d'un nouveau point d'attention ou veut une nouvelle notification. +--- + +# Ajouter un domaine (une nouvelle notification) + +Un domaine reprend le travail fait pour Energy : des analyses sans LLM, un verdict par jour, une notification au client et au support (D-020, D-022, D-025, D-030). Sept étapes ; **chacune s'arrête pour l'avis de l'utilisateur**, qui décide si la suivante est utile. Pour tout ce qui touche à une analyse, suivre le skill `nouvelle-analyse`, sans le répéter ici. + +## 1. Situer le domaine + +- Nom en anglais, en un mot, comme `energy`, `storage` ou `cellular`. Question du domaine en une phrase. +- Lire `docs//domaine/point-de-depart.md`. S'il n'existe pas, créer `src//__init__.py` (vide) et la note, avec les sections de `docs/storage/domaine/point-de-depart.md` : question du domaine ; ce que mesure le collecteur (métriques, unités, ligne source dans `docs/aimsight/collecteur_system_info.py`, nom exporté dans `SYNC_SPEC`) ; ce que montrent les données (instantanés de `data/metadata.md`, exports reçus) ; ce qu'en dit la doc AIMsight (lire par section) ; pièges connus ; CSV reçus et manquants ; pistes d'analyses (non décidées). +- Lire `docs/decisions.md` (index : `grep -n '^## D-'`) pour les options déjà écartées. + +## 2. Recevoir les données + +- Les CSV vont dans `data//` (D-029). Le jeu de travail du domaine est noté dans `CLAUDE.md` et dans sa décision (VERMONT pour Energy, WEISSHORN pour `storage` et `cellular`). +- Copies de téléchargement `… (1).csv` : les comparer à l'original (`cmp`) ; identiques, les supprimer ; différentes, demander à l'utilisateur. Supprimer les `*:Zone.Identifier` (ignorés par git). +- Vérifier le chargement par `common.stations.load_stations`, **stderr redirigé** : le chargeur imprime les valeurs illisibles, dont des identifiants (`ip`). `SIM_CCID`, lui, se charge comme un nombre : ne jamais afficher ses valeurs. +- Les métriques texte (listes d'échantillons par heure, ex. `link`) sont ignorées par le chargeur. L'adapter seulement si une analyse en a besoin. +- Relever la couverture, le pas de temps et les trous ; versionner `data//`. + +## 3. Explorer + +- Par script, jamais en affichant les CSV ; ne jamais recopier d'identifiant de station dans `docs/`. +- Compléter la note de départ avec les faits observés : plages, cycles jour/nuit, sauts, trous, nombre d'échantillons par heure. +- Croiser avec Energy : un trou pendant une coupure d'énergie n'appartient pas au domaine (`docs/domaine/pieges-des-donnees.md`). +- Repérer, en passant, les champs d'autres points d'attention : les proposer comme domaines, ne pas les traiter. + +## 4. Recueillir les cas de référence + +- Demander à l'expert des périodes annotées, normales ou à problème, et les ranger dans `docs//domaine/cas-annotes-par-l-expert.md` (modèle : `docs/energy/domaine/cas-annotes-par-l-expert.md`). +- Sans cas annotés, pas de verdict livré. Un export sans incident sert à décrire le régime normal. + +## 5. Écrire les analyses + +- Une analyse par question, avec le skill `nouvelle-analyse` : fiche dans `docs//analyses/`, calcul embarquable dans `src//`, constantes sourcées, contrat `run(series)`. +- Seuils : ceux du matériel ou de la documentation, avec leur source ; sinon comparer la station à son propre passé. Préférer des fenêtres de plusieurs jours, multiples de 24 h. +- La première analyse crée la page de comparaison du domaine, `src//all_analyses.py` (D-016), sur le modèle de `src/energy/all_analyses.py`. + +## 6. Produire le verdict du jour (contrat de notification) + +- `src//day_color.py`, sur le modèle de `src/energy/day_color.py` : + - `run(series) -> {analysis, rule, points}`, un point par jour UTC, causal, `anomaly = None`, la couleur dans `facts.color` : `GREEN`, `ORANGE`, `RED` ou `None` (inconnu, gris) ; + - `HEADLINE = {"RED": "...", "ORANGE": "..."}` : une phrase en anglais par couleur notifiée (D-023). Green ne notifie rien (D-025). +- Ce que veut dire Red pour ce domaine, et la combinaison des analyses (une matrice tenue par l'utilisateur si elle est utile), se décident avec l'utilisateur. + +## 7. Livrer et documenter + +- Figure du site : `src//final.py`, sur le modèle de `src/energy/final.py` (D-021), en anglais. +- Maquettes : proposer, puis attendre les consignes de l'utilisateur. Côté support, une notification sur `maquettes/support/home.py` ; côté client, un bloc dans la section Diagnostic. +- **Si les maquettes ne parcourent pas encore une liste de domaines, faire ce passage d'abord, une seule fois** : déplacer `HEADLINE` d'Energy de `maquettes/support/home.py` vers `src/energy/day_color.py`, puis remplacer l'appel direct à `energy.day_color` par `DOMAINS = {"Energy": energy.day_color, "": .day_color}`, parcouru pour les notifications (D-030). +- Guide : `docs//guide/`, en deux couches, client puis support (D-020). +- `CLAUDE.md` : tableau des analyses du domaine, « État et prochaine étape », commandes, carte. `docs/decisions.md` : une entrée pour le nouveau domaine (jeu de travail, sens des couleurs). diff --git a/.claude/skills/nouvelle-analyse/SKILL.md b/.claude/skills/nouvelle-analyse/SKILL.md index b938955..92cccdc 100644 --- a/.claude/skills/nouvelle-analyse/SKILL.md +++ b/.claude/skills/nouvelle-analyse/SKILL.md @@ -7,7 +7,7 @@ description: Créer une nouvelle analyse dans le projet de diagnostic AIMsight ## 1. Situer l'analyse -- **Domaine** : Energy (`src/energy/`, `docs/energy/`) ou un nouveau domaine, qui reçoit alors son propre `src//` et `docs//` (D-026). Le demander à l'utilisateur en cas de doute. +- **Domaine** : Energy (`src/energy/`, `docs/energy/`), Storage, Cellular, ou un nouveau domaine, qui reçoit alors son propre `src//` et `docs//` (D-026). Un domaine qui n'existe pas encore se crée d'abord avec le skill `nouveau-domaine` (D-030). Le demander à l'utilisateur en cas de doute. - **Nom de la règle** : en anglais, en majuscules, **en mots complets sans abréviation** (ex. `MOVING_AVERAGE_7_DAYS_DROP`, D-017). Les analyses ne sont pas numérotées : le nom de la règle les désigne (D-026). - Lire, sans tout charger : - les « Pistes » et les « Limites connues » des fiches du domaine (`docs//analyses/`). La nouvelle analyse en couvre souvent une ; @@ -38,8 +38,8 @@ description: Créer une nouvelle analyse dans le projet de diagnostic AIMsight ## 4. Vérifier -- Lancer la page de comparaison du domaine sur VERMONT (pour Energy, `python3 src/energy/all_analyses.py`). -- Comparer les résultats au diagnostic expert (`docs/energy/domaine/cas-annotes-par-l-expert.md`). +- Lancer la page de comparaison du domaine sur son jeu de travail (pour Energy, VERMONT : `python3 src/energy/all_analyses.py` ; pour Storage et Cellular, WEISSHORN, D-030). +- Comparer les résultats au diagnostic expert (`docs//domaine/cas-annotes-par-l-expert.md`). - Reporter les dates et valeurs observées dans la section « Résultats » de la fiche. ## 5. Documenter