Notre avis

Résout automatiquement les erreurs PHPStan en analysant et corrigeant les problèmes de types par lots, en bouclant jusqu'à zéro erreur ou stagnation.

Points forts

Réduit considérablement le temps de correction manuelle des erreurs PHPStan
Traitement par lots avec délégation à un sous-agent pour chaque correction
Génération d'un rapport final détaillant le nombre d'erreurs corrigées et le taux de succès
Gestion des cas de stagnation et d'itérations maximales

Limites

Fonctionne uniquement avec PHPStan, pas avec d'autres outils d'analyse statique
Les corrections automatiques peuvent introduire de nouvelles erreurs si le contexte est mal interprété
Limitée aux erreurs de typage et ne couvre pas les problèmes architecturaux profonds

Quand l'utiliser

Utilisez cette compétence lorsque votre projet PHP contient un grand nombre d'erreurs PHPStan que vous souhaitez corriger de manière systématique et itérative.

Quand l'éviter

Évitez de l'utiliser lorsque les erreurs nécessitent des changements architecturaux profonds ou quand chaque correction doit être examinée manuellement pour des raisons de sécurité ou de logique métier.

Exemples

Fix all PHPStan errors

/qa:phpstan

Resolve PHPStan errors batch by batch

Run the PHPStan error resolver workflow to fix type errors in the codebase, correcting 5 errors per iteration.

Iterative PHPStan resolution with report

Automatically resolve PHPStan errors using the resolver skill, then generate a summary of fixes.

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 :

TaskUpdate → tâche en in_progress
Exécuter l'étape
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

Vérifier environnement PHPStan
Exécuter analyse initiale (--error-format=json)
Grouper erreurs par fichier
Boucle de résolution :
- Déléguer corrections à @phpstan-error-resolver
- Re-exécuter PHPStan
- Répéter jusqu'à 0 erreur ou stagnation
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

Résolveur d'Erreurs PHPStan

Recommandé pour