Apartment38/Agent-Skills

Maintenance des skins Hermes

Utilisez cette compétence pour auditer, étendre ou réparer un skin Hermes existant tout en préservant son caractère visuel dans l'interface CLI, TUI et de bureau.

Autorité et périmètre

• Le contrat canonique des couleurs inter-surfaces est SKIN_COLOR_TOKENS dans apps/shared/src/skin.ts du dépôt Hermes Agent. Récupérez le fichier brut à partir de la branche demandée par l'utilisateur, ou main lorsqu'aucune révision n'est spécifiée.
• Un skin peut contenir des clés héritées ou spécifiques, mais la couverture des tokens doit être mesurée uniquement par rapport à la liste canonique. Ne supprimez pas les extensions compatibles simplement parce qu'elles sont absentes de cette liste.
• Résolvez le répertoire Hermes actif depuis $HERMES_HOME ; s'il n'est pas défini, utilisez ~/.hermes. Ne modifiez jamais config.yaml à la main.

Procédure

1. Chargez les instructions de thématisation Hermes si disponibles et inspectez le YAML du skin cible.
2. Récupérez et analysez SKIN_COLOR_TOKENS ; n'inférez pas la liste à partir d'un ancien modèle.
3. Calculez les clés manquantes par programmation à partir du mappage colors du skin.
4. Ajoutez uniquement les clés canoniques manquantes. Préservez les valeurs existantes et attribuez de nouvelles couleurs par famille sémantique plutôt que d'inventer des teintes non liées :
   • background : une base sombre ou claire qui correspond au skin établi.
   • primary/text/border : réutilisez la palette existante des titres, corps et structure.
   • tool/thinking : héritez des couleurs d'accentuation et d'étiquette secondaire du skin, sauf si une distinction de contraste intentionnelle existe.
   • diff/status/syntax : mappez positif→ok, avertissement/nombre→warn, négatif→error ; utilisez une nuance légèrement plus forte pour les diffs au niveau des mots et les statuts critiques.
   • chrome du terminal : réutilisez la hiérarchie prompt/accent/texte de manière cohérente.
5. Conservez toutes les valeurs sous forme de couleurs #rrggbb à six caractères entre guillemets.
6. Validez le YAML et vérifiez que chaque token canonique est désormais présent.
7. Appliquez le skin modifié avec hermes config set display.skin <nom> et relisez hermes config get display.skin avant de signaler la réussite.

Liste de vérification

Signalez ces vérifications exactes :

• Le chemin du fichier cible et le name du skin intégré concordent.
• Le YAML s'analyse correctement.
• missing_tokens=none par rapport à la liste canonique SKIN_COLOR_TOKENS récupérée.
• Le skin actif se résout au nom cible après l'avoir appliqué.

Pièges

• La palette existante du skin peut intentionnellement omettre background ; son ajout reste nécessaire pour un rendu fiable de la surface de base en desktop/TUI.
• status_bar_bad et status_bar_critical sont distincts. Ne vous arrêtez pas à la palette modèle plus ancienne et plus petite.
• Lors du changement du fournisseur de modèle configuré dans la même session, supprimez un model.base_url personnalisé hérité après avoir sélectionné un fournisseur OAuth ; sinon un ancien point de terminaison local peut rester dans la configuration. Vérifiez le statut d'authentification du fournisseur sélectionné avant de déclarer la migration terminée.
• Ne modifiez pas les skills Hermes fournis ou appartenant à l'utilisateur. Créez ou mettez à jour un skill compagnon géré par un conservateur à la place.