Quality assurance : PHPStan automatisé, tests, linters avec skills spécialisés

GitHub stars
9

Install

/plugin install qa@atournayre-claude-plugin-marketplace

Run it inside Claude Code after adding the marketplace with /plugin marketplace add atournayre/claude-marketplace.

Contents

Discovered from source

Skills 2

Elegant Objects Reviewer Skill

Instructions à Exécuter

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

Usage

/qa:elegant-objects [fichier.php]

Sans argument : analyse les fichiers PHP modifiés dans la branche.

Workflow

  1. Déterminer fichiers à analyser (argument ou git diff)
  2. Vérifier les règles Elegant Objects
  3. Générer rapport avec score

Règles vérifiées

Classes

  • Classes final (sauf abstraites)
  • Max 4 attributs
  • Pas de getters/setters
  • Pas de méthodes statiques
  • Noms sans -er (Manager, Handler, Helper...)
  • Constructeur unique et simple

Méthodes

  • Pas de retour null
  • Pas d'argument null
  • Corps sans lignes vides ni commentaires
  • CQRS : séparation commandes/queries

Tests

  • Une assertion par test (dernière instruction)
  • Noms en français décrivant le comportement
  • Pas de setUp/tearDown

Score

  • Violation critique: -10 points
  • Violation majeure: -5 points
  • Recommandation: -2 points
  • Base: 100

References

Notes

  • Ignorer vendor/, var/, cache/
  • Controllers Symfony tolérés
  • Prioriser par criticité

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

Error Handling

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

Sponsors

Details

Marketplace
atournayre/claude-marketplace
Source
qa
Category
Community

More from atournayre/claude-marketplace

All 18