health

Vue d’ensemble du skill health

Ce que fait le skill health

health lance un audit de santé d’agent, pensé pour le budget, pour Codex, Claude Code, Pi, les instructions d’agent, les hooks/MCP, les surfaces de vérification et la maintenabilité de l’IA. Il s’adresse aux personnes qui ont besoin d’un guide pratique pour comprendre pourquoi un agent ignore des instructions, saute la vérification ou dérive vers un comportement difficile à maintenir.

Cas d’usage idéal et rôle principal

Utilisez ce skill health quand vous avez besoin d’un contrôle rapide de la configuration et du workflow, pas d’une revue de code. Il est particulièrement utile pour des travaux de type Security Audit, car il permet de voir si la pile d’agents est suffisamment fiable pour servir de base avant d’examiner la logique applicative, la gestion des secrets ou la conformité aux politiques.

Ce qui le différencie

Ce skill adopte une vision tranchée de la santé d’un agent en couches : surfaces de configuration, fichiers d’instructions, outils/runtime, vérificateurs et maintenabilité. Le résultat est donc plus exploitable pour prendre une décision qu’un prompt générique, car il peut pointer la couche désalignée au lieu de se contenter d’un vague « quelque chose cloche ».

Comment utiliser le skill health

Contexte d’installation et premiers fichiers à lire

Installez le skill health avec npx skills add tw93/Waza --skill health. Après l’installation, lisez d’abord SKILL.md, puis examinez agents/inspector-context.md, agents/inspector-control.md et agents/inspector-maintainability.md pour comprendre ce qu’attend l’audit et quelles preuves il privilégie.

Quel type d’entrée le skill attend

Le skill health fonctionne mieux si vous fournissez des signaux propres au dépôt : fichiers d’instructions d’agent, paramètres de hooks ou de MCP, commandes de vérification, et symptômes comme « Claude ignore AGENTS.md » ou « la config Codex semble correcte, mais le comportement est incohérent ». Pour obtenir un résultat vraiment utile, indiquez le chemin exact du dépôt, la plateforme d’agent et le mode de défaillance observé.

Comment formuler une demande solide

Une demande faible serait « vérifie la santé ». Une demande plus forte serait : « Lance un audit health sur ce dépôt pour Claude Code et Codex. Concentre-toi sur l’empilement des instructions, les hooks, la couverture des vérifications et le risque de dégradation de la maintenabilité de l’IA. Signale tout chemin cassé, toute référence obsolète ou toute surface de vérification manquante. » Cela donne au skill assez de périmètre pour produire un audit réellement exploitable.

Workflow et ordre de lecture du dépôt

Commencez par les scripts de collecte du dépôt s’ils existent, puis examinez les sorties de l’audit avant de lire le code source brut. Dans ce dépôt, les chemins pratiques sont scripts/check_agent_context.py, scripts/check_doc_refs.py, scripts/check_maintainability.py et scripts/check_verifier_output.py. Cet ordre permet d’identifier où se situe le problème avant de passer à une inspection manuelle de tous les fichiers.

FAQ du skill health

Est-ce réservé aux vérifications d’installation ?

Non. Le skill health sert aux audits de configuration d’agents, à l’analyse de la dérive des instructions, aux lacunes de vérification et aux risques de maintenabilité. Il n’est pas conçu pour déboguer des bugs applicatifs ni pour relire un diff de pull request.

Quand ne pas utiliser le skill health ?

Ne l’utilisez pas si vous voulez seulement un correctif au niveau du code, un diagnostic de bug ou une réécriture ponctuelle d’un prompt. Si le dépôt est minuscule et ne comporte aucune surface agent, un prompt simple suffit généralement ; le skill health devient vraiment utile lorsqu’il y a plusieurs fichiers d’agent, des hooks ou plusieurs couches de vérification.

Le skill health est-il adapté aux débutants ?

Oui, si vous pouvez fournir le dépôt et le symptôme. L’erreur la plus fréquente chez les débutants consiste à demander un vague « health check » sans préciser quel agent, quelle surface d’instruction ou quelle étape de vérification semble cassée. Plus l’entrée est précise, plus la sortie est exploitable.

En quoi est-il différent d’un prompt générique ?

Un prompt générique peut résumer des préoccupations, mais le skill health est conçu pour inspecter méthodiquement les surfaces d’agent et répartir son attention de façon raisonnée. C’est important quand vous devez décider si un install health convient à des workflows de Security Audit, où une validation absente ou des instructions obsolètes peuvent miner la confiance en silence.

Comment améliorer le skill health

Donnez-lui le bon symptôme et le bon périmètre

Indiquez si vous vous intéressez à Claude Code, Codex, Pi ou aux trois, et nommez la défaillance : instructions ignorées, hooks manquants, couverture de vérification insuffisante ou dérive de la maintenabilité de l’IA. Si le périmètre est clair, le skill évite de gaspiller de l’attention sur une structure de dépôt sans rapport.

Fournissez des preuves, pas seulement une conclusion

Les entrées les plus fortes incluent les fichiers pertinents ou des extraits : AGENTS.md, les couches locales de superposition d’instructions, les paramètres, la configuration des hooks et toute sortie de commande qui montre l’échec. Par exemple, « AGENTS.md dit de vérifier avec make test, mais le dépôt n’a que pytest -q » est bien plus utile que « les tests semblent bizarres ».

Itérez après le premier audit

Servez-vous du premier résultat pour déterminer s’il s’agit d’un problème d’empilement des instructions, d’un décalage outil/runtime ou d’une faiblesse du vérificateur, puis relancez avec une cible plus étroite. Si le skill indique que la pile d’agents est saine mais que la maintenabilité est fragile, demandez un second passage centré sur la densité des TODO, l’ownership des points chauds et les références doc obsolètes, au lieu de ré-auditer tout le dépôt.