mes_skills/skills/infra/ha-log-investigator/references/skill-update.md

Mise à jour du skill

Objectif

Mettre à jour ha-log-investigator lorsqu'une évolution officielle de Home Assistant modifie la manière correcte de collecter les preuves, d'interroger l'API, de lire les logs, de traiter les dashboards, les réparations ou les fichiers de configuration.

Déclencheurs

Lancer ce workflow si :

• une documentation officielle contredit le comportement actuel du skill ;
• une commande documentée change ;
• une API officielle évolue ;
• un mode d'installation modifie ses chemins ou ses sources de logs ;
• un test réel révèle une hypothèse devenue obsolète.

Workflow de mise à jour

1. Identifier l'évolution constatée.
2. Vérifier l'information dans une source officielle Home Assistant.
3. Décrire l'écart entre :
   • comportement actuel du skill ;
   • comportement officiel attendu.
4. Mettre à jour uniquement les fichiers nécessaires :
   • SKILL.md
   • références concernées
   • scripts concernés
   • templates concernés
5. Ajouter une entrée dans history.md avec :
   • date ;
   • évolution observée ;
   • source officielle ;
   • fichiers modifiés ;
   • conséquence pratique.
6. Revalider le skill.
7. Si possible, retester sur un cas réel ou un artefact réaliste.

Règles

• Ne jamais supprimer l'historique existant.
• Ne pas mettre à jour le skill sur la base d'un forum, d'un blog ou d'une intuition seule.
• Si une évolution est suspectée mais non confirmée officiellement, l'ajouter dans la section À surveiller de history.md au lieu de modifier le comportement du skill.
• Conserver la compatibilité avec les versions anciennes seulement si elle est encore utile et documentée.