gh-atournayre-claude-marketplace-qa/skills/elegant-objects/SKILL.md

name, description, allowed-tools, model

name	description	allowed-tools	model
elegant-objects	Vérifie la conformité du code PHP aux principes Elegant Objects de Yegor Bugayenko. Analyse un fichier spécifique ou tous les fichiers modifiés dans la branche.	Bash Read Grep Glob	sonnet

Elegant Objects Reviewer Skill

Variables

TARGET="$ARGUMENTS"  # Fichier spécifique ou vide pour fichiers modifiés

Workflow

Étape 1: Déterminer les fichiers à analyser

if [ -n "$TARGET" ] && [ -f "$TARGET" ]; then
    # Fichier spécifique fourni
    FILES_TO_ANALYZE="$TARGET"
    echo "📁 Analyse du fichier: $TARGET"
else
    # Fichiers PHP modifiés dans la branche
    BASE_BRANCH=$(git rev-parse --abbrev-ref HEAD@{upstream} 2>/dev/null || echo "main")
    FILES_TO_ANALYZE=$(git diff --name-only "$BASE_BRANCH"...HEAD -- '*.php' 2>/dev/null || git diff --name-only HEAD -- '*.php')

    if [ -z "$FILES_TO_ANALYZE" ]; then
        echo "⚠️ Aucun fichier PHP modifié détecté"
        exit 0
    fi

    echo "📁 Fichiers PHP modifiés dans la branche:"
    echo "$FILES_TO_ANALYZE" | while read f; do echo "  - $f"; done
fi

Étape 2: Analyser chaque fichier

Pour chaque fichier PHP, vérifier les règles Elegant Objects.

Règles de conception des classes

1. Classes final - Toutes les classes doivent être final (sauf abstraites)
2. Attributs max 4 - Chaque classe encapsule 1 à 4 attributs maximum
3. Pas de getters - Éviter les méthodes getX() (modèle anémique)
4. Pas de setters - Éviter les méthodes setX() (mutabilité)
5. Pas de méthodes statiques - Strictement interdites dans les classes
6. Pas de classes utilitaires - Classes avec uniquement des méthodes statiques interdites
7. Noms sans -er - Noms de classes ne finissant pas par -er (Manager, Handler, Helper...)
8. Constructeur unique - Un seul constructeur principal par classe
9. Constructeurs simples - Ne contiennent que des affectations

Règles de méthodes

1. Pas de retour null - Les méthodes ne doivent jamais retourner null
2. Pas d'argument null - null ne doit pas être passé en argument
3. Corps sans lignes vides - Les corps de méthodes sans lignes vides
4. Corps sans commentaires - Les corps de méthodes sans commentaires inline
5. Noms verbes simples - Noms de méthodes sont des verbes simples (pas composés)
6. CQRS - Séparation commandes (void) et queries (retour valeur)

Règles de style

1. Messages sans point final - Messages d'erreur/log sans point final
2. Messages une phrase - Messages d'erreur/log en une seule phrase
3. Fail fast - Exceptions lancées au plus tôt

Règles de tests

1. Une assertion par test - Chaque test ne contient qu'une assertion
2. Assertion dernière - L'assertion est la dernière instruction
3. Pas de setUp/tearDown - Ne pas utiliser ces méthodes
4. Noms français - Noms de tests en français décrivant le comportement
5. Messages négatifs - Assertions avec messages d'échec négatifs
6. Pas de constantes partagées - Pas de littéraux statiques partagés

Étape 3: Générer le rapport

Format du rapport:

## Score de conformité Elegant Objects

Score global: X/100

## Violations critiques (bloquantes)

### [Règle violée]
- **Fichier:** /chemin/fichier.php:ligne
- **Problème:** Description précise
- **Suggestion:** Code corrigé ou approche

## Violations majeures (à corriger)

[Même format]

## Recommandations (améliorations)

[Même format]

## Statistiques

- Fichiers analysés: X
- Classes analysées: Y
- Méthodes analysées: Z
- Tests analysés: W
- Total violations: N

## Prochaines étapes

Liste priorisée des corrections à effectuer

Calcul du score

• Violation critique: -10 points
• Violation majeure: -5 points
• Recommandation: -2 points
• Score de base: 100

Patterns à détecter (regex)

# Classes non-final
/^class\s+\w+/  # sans 'final' avant

# Getters
/public\s+function\s+get[A-Z]\w*\s*\(/

# Setters
/public\s+function\s+set[A-Z]\w*\s*\(/

# Méthodes statiques
/public\s+static\s+function/

# Noms en -er
/class\s+\w+(er|or|Manager|Handler|Helper|Builder|Factory|Provider|Controller|Processor)\b/

# Retour null
/return\s+null\s*;/

# Lignes vides dans méthodes
/\{\s*\n\s*\n/  # ouverture suivie de ligne vide

# Commentaires dans corps
/^\s+\/\//  # à l'intérieur des méthodes

Notes

• Ignorer fichiers vendor/, var/, cache/
• Contexte framework Symfony considéré (Controllers tolérés)
• Prioriser violations par criticité
• Proposer code corrigé quand possible