---

name: phpstan-resolver description: > Résout automatiquement les erreurs PHPStan en analysant et corrigeant les problèmes de types. Boucle jusqu'à zéro erreur ou stagnation. allowed-tools: [Task, Bash, Read, Edit, Grep, Glob] model: claude-opus-4-1-20250805

PHPStan Error Resolver Skill

Instructions à Exécuter

IMPORTANT : Exécute ce workflow étape par étape :

Usage

/qa:phpstan

Configuration

PHPSTAN_BIN="./vendor/bin/phpstan"
PHPSTAN_CONFIG="phpstan.neon"  # ou phpstan.neon.dist
ERROR_BATCH_SIZE=5
MAX_ITERATIONS=10

Workflow

Initialisation

Créer les tâches du workflow :

Utiliser TaskCreate pour chaque phase :

TaskCreate #1: Vérifier environnement PHPStan
TaskCreate #2: Exécuter analyse initiale (--error-format=json)
TaskCreate #3: Grouper erreurs par fichier
TaskCreate #4: Boucle de résolution (max 10 itérations)
TaskCreate #5: Générer rapport final

Important :

• Utiliser activeForm (ex: "Vérifiant environnement PHPStan", "Résolvant erreurs")
• La tâche #4 peut prendre du temps (boucle jusqu'à 10 itérations)
• Chaque tâche doit être marquée in_progress puis completed

Pattern d'exécution pour chaque étape :

1. TaskUpdate → tâche en in_progress
2. Exécuter l'étape
3. TaskUpdate → tâche en completed

Spécial pour la boucle de résolution (tâche #4) :

• Marquer en in_progress au début de la boucle
• Ne marquer en completed qu'à la fin (0 erreur, stagnation, ou max itérations)
• Le statut reste in_progress pendant toutes les itérations

Étapes

1. Vérifier environnement PHPStan
2. Exécuter analyse initiale (--error-format=json)
3. Grouper erreurs par fichier
4. Boucle de résolution :
   • Déléguer corrections à @phpstan-error-resolver
   • Re-exécuter PHPStan
   • Répéter jusqu'à 0 erreur ou stagnation
5. Générer rapport final

Délégation

Utilise l'agent @phpstan-error-resolver pour les corrections :

• Batch de 5 erreurs par fichier par itération
• Maximum 10 itérations

Rapport

details:
  total_errors_initial: X
  total_errors_final: Y
  errors_fixed: Z
  success_rate: "X%"
  iterations: N

Task Management

Progression du workflow :

• 5 tâches créées à l'initialisation
• La tâche #4 (boucle) reste in_progress pendant toutes les itérations
• Chaque tâche suit le pattern : in_progress → exécution → completed
• Utiliser TaskList pour voir la progression (notamment pour la boucle longue)
• Les tâches permettent à l'utilisateur de suivre la résolution progressive des erreurs

References

• Scripts de workflow - Scripts bash détaillés

Error Handling

• PHPStan non trouvé → ARRÊT
• Config absente → ARRÊT
• Stagnation → ARRÊT avec rapport
• Max itérations → ARRÊT avec rapport