Add the nouveau-domaine skill to add a notification domain
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
504c8634e3
commit
22afd57b55
2 files changed
+58
-3
No files matched your search
@@ -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>/domaine/point-de-depart.md`. S'il n'existe pas, créer `src/<domaine>/__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/<STATION>/` (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/<STATION>/`.
|
||||
|
||||
## 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>/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/<domaine>/analyses/`, calcul embarquable dans `src/<domaine>/`, 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/<domaine>/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/<domaine>/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/<domaine>/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, "<Domaine>": <domaine>.day_color}`, parcouru pour les notifications (D-030).
|
||||
- Guide : `docs/<domaine>/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).
|
||||
@@ -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/<domaine>/` et `docs/<domaine>/` (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/<domaine>/` et `docs/<domaine>/` (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/<domaine>/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>/domaine/cas-annotes-par-l-expert.md`).
|
||||
- Reporter les dates et valeurs observées dans la section « Résultats » de la fiche.
|
||||
|
||||
## 5. Documenter
|
||||
|
||||
Reference in new issue
Block a user