tw93/santé

Que fait santé ?

Réalise un audit de santé technique assisté par agent, conscient du budget, pour détecter les dérives d'instructions/config, les hooks/MCP, les surfaces de vérification, et la maintenabilité IA. À utiliser lorsque les utilisateurs demandent 检查claude/检查codex/检查pi/配置检查/健康度 ou signalent que les agents ignorent les instructions, manquent de validation, ou que le code devient difficile à maintenir. Ne convient pas pour déboguer du code ou examiner des PRs.

Comportement

• Vérification de la dérive des instructions : Compare CLAUDE.md / .cursorrules avec la configuration runtime de l'agent (par exemple, mcp.json, settings.json) pour détecter les écarts.
• Analyse des hooks/MCP : Liste tous les hooks et points de terminaison MCP enregistrés et vérifie qu'ils pointent vers des binaires/scripts existants.
• Contrôle des surfaces de vérification : Examine les scripts de vérification post-édition (par exemple, tests/, scripts/verify*, lints/) pour des modèles courants de validation manquante.
• Évaluation de la maintenabilité : Analyse la taille des fichiers d'instructions, le nombre de règles et les commentaires de dépendances obsolètes.
• Conscient du budget : Évalue les jetons d'entrée estimés ; s'abstient si > 40k. L'utilisateur peut forcer avec --force.
• Orientation vers l'action : Produit un résumé des problèmes et des suggestions améliorables (par exemple, "ajouter un hook de vérification pour le formatage", "mettre à jour CLAUDE.md avec la section des variables manquantes").
• Focus sécurité : Demande la permission avant de modifier des fichiers.

Utilisation

1. Demandez « santé » ou « audit de santé » dans un répertoire de projet.
2. L'agent énumère les fichiers de configuration pertinents.
3. L'agent exécute grep, find, des linters (si disponibles) et des scripts de vérification.
4. L'agent imprime un rapport structuré et demande s'il doit appliquer les corrections.

Exemple

> Exécuter un audit de santé

[Agent] Vérification de la dérive des instructions :
  - CLAUDE.md définit un hook de vérification 'npm test' mais mcp.json ne contient aucun hook de vérification.

Analyse des surfaces de vérification :
  - 'scripts/verify.sh' trouvé mais jamais exécuté dans les hooks.

Maintenabilité :
  - CLAUDE.md dépasse 200 lignes. Envisager une extraction.

Suggéré : Ajouter les hooks manquants, diviser CLAUDE.md. Appliquer ? (y/N)

Dépannage

• Budget de jetons atteint : Essayez --force ou auditez manuellement un sous-ensemble de fichiers.
• Linters manquants : L'audit fonctionne sans, mais moins de suggestions.
• Grands monorepos : Le skill se limite automatiquement aux 3 premiers répertoires de configuration/d'instructions.

Voir aussi

• tw93/sync – synchronisation de la configuration entre les agents
• tw93/rules – partage de règles multi-agents