Files
Support-Agent/.claude/skills/nouvelle-analyse/SKILL.md
T

53 lines
3.8 KiB
Markdown

---
name: nouvelle-analyse
description: Créer une nouvelle analyse dans le projet de diagnostic AIMsight — règle, fiche, code dans son domaine, panneau de comparaison, index, journal. À utiliser dès que l'utilisateur veut ajouter, concevoir ou prototyper une nouvelle analyse des séries temporelles d'une station.
---
# Créer une nouvelle analyse
## 1. Situer l'analyse
- **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 ;
- `docs/decisions.md`, en particulier les options écartées ;
- la note de `docs/domaine/` ou de `docs/<domaine>/domaine/` qui concerne la question posée.
- Si la conception demande des choix, en discuter avec l'utilisateur. Avec superpowers (brainstorming), **la spec s'écrit directement dans la fiche**, pas dans `docs/superpowers/specs/` (D-010).
## 2. Écrire la fiche
- Copier `modele-fiche.md` (à côté de ce fichier) vers `docs/<domaine>/analyses/<règle en minuscules>.md` (ex. `daily_battery_state.md`) et remplir :
- la question posée ;
- le principe et le calcul exact ;
- les constantes **avec leur source** ;
- les options écartées.
- Statut : « en conception ».
## 3. Écrire le code
- Le calcul respecte le contrat commun : `run(series) -> {analysis, rule, points: [{t, value, anomaly, facts}]}`.
- Il est causal.
- Il utilise uniquement la bibliothèque standard, sans importer `src/common/` : il doit pouvoir s'embarquer seul.
- `value` est exprimé dans une unité physique, sans pseudo-probabilité.
- Une analyse seule conclut au plus `consistent with`.
- Le module va dans `src/<domaine>/`. Les séries arrivent par `common.stations.load_stations`. Extraire du code partagé seulement quand une deuxième analyse en a vraiment besoin.
- **Pas de point d'entrée par analyse** : ajouter le panneau de l'analyse à la page de comparaison du domaine (pour Energy, `figure()` et `main()` de `src/energy/all_analyses.py`). Si l'analyse devient livrée, elle rejoint aussi la page livrée (pour Energy, `src/energy/final.py`).
- Graphique (D-011) : en haut, l'analyse avec ses courbes superposées ; dessous, un graphique par série temporelle. Écrire le HTML avec `post_script=common.page.AUTOSCALE_Y_JS` et des ordonnées en `fixedrange`, pour que l'ordonnée se recale à chaque zoom.
- Pas de tests automatisés en phase prototype (D-008).
## 4. Vérifier
- 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
- Fiche : statut « prototype en place », résultats, limites, historique.
- `CLAUDE.md` :
- ajouter une ligne au tableau des analyses du domaine ;
- mettre à jour « État et prochaine étape ».
- `docs/decisions.md` : une entrée **seulement** si une décision de niveau projet a été prise (nouveau principe, changement de cap, nouveau domaine). Les choix propres à l'analyse restent dans sa fiche.
- Un savoir métier découvert en chemin va dans `docs/domaine/` (commun) ou `docs/<domaine>/domaine/`.