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

3.8 KiB

name, description
name description
nouvelle-analyse 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/.