Notre avis
Implémente une fonctionnalité en suivant un plan de développement préétabli, avec validation qualité automatique (PHPStan, formatage PSR-12).
Points forts
- Assure le respect du plan et des conventions du projet
- Automatise les vérifications de qualité (PHPStan niveau 9) et le formatage PSR-12 après chaque modification
- Intègre une approche TDD pour la création de tests unitaires
Limites
- Nécessite un plan préexistant généré par une phase précédente (ex: /dev:plan)
- Les vérifications qualité dépendent de la présence d'outils comme PHPStan ou php-cs-fixer dans le projet
- Ne couvre que les fichiers PHP pour les hooks automatiques
Quand vous avez un plan détaillé et souhaitez implémenter une fonctionnalité étape par étape avec des contrôles qualité intégrés.
Pour des tâches simples ou exploratoires ne nécessitant pas de plan formel, ou si le projet n'utilise pas PHP.
Analyse de sécurité
SûrThe skill uses Bash hooks to run linters and formatters (PHPStan, php-cs-fixer) on PHP files, which are legitimate development quality tools. There are no destructive commands, no exfiltration, and no obfuscated payloads. The workflow instructs the agent to implement code according to a plan, which is within the agent's normal operation.
Aucun point d'attention détecté
Exemples
/dev:code path/to/plan.md/dev:codeContinue with Phase 5: implement the feature according to the plan we created earlier.name: dev:code description: Implémenter selon le plan (Phase 5) argument-hint: [path-to-plan] model: sonnet allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, TaskCreate, TaskUpdate, TaskList] version: 1.0.0 license: MIT hooks: PreToolUse: - matcher: "Read" hooks: - type: command command: | # Hook 3: Vérifier qu'on a un plan à suivre if [ -f ".claude/data/.dev-workflow-state.json" ]; then PLAN_PATH=$(jq -r '.planPath // empty' .claude/data/.dev-workflow-state.json 2>/dev/null || echo "") if [ -z "$PLAN_PATH" ] || [ ! -f "$PLAN_PATH" ]; then echo "❌ ERREUR : Aucun plan trouvé" echo "Lance d'abord : /dev:plan" exit 1 fi fi once: true PostToolUse: - matcher: "Edit" hooks: - type: command command: | # Hook 1: PHPStan après chaque Edit (fichiers PHP uniquement) FILE=$(echo "$CLAUDE_TOOL_ARGS" | grep -oP '(?<=file_path: ).*?(?=,|$)' || echo "")
if [ -n "$FILE" ] && [[ "$FILE" == *.php ]]; then
echo "🔍 Vérification PHPStan de $FILE..."
if [ -f "Makefile" ] && grep -q "^phpstan:" Makefile; then
make phpstan FILES="$FILE" 2>/dev/null || vendor/bin/phpstan analyse "$FILE" --level=9 --no-progress 2>/dev/null || echo "⚠️ PHPStan non disponible"
elif [ -f "vendor/bin/phpstan" ]; then
vendor/bin/phpstan analyse "$FILE" --level=9 --no-progress || {
echo "⚠️ Erreurs PHPStan détectées dans $FILE"
echo "Corrige-les avant de continuer"
}
fi
fi
once: false
- matcher: "Write"
hooks:
- type: command
command: |
# Hook 2: Auto-format après Write (fichiers PHP uniquement)
FILE=$(echo "$CLAUDE_TOOL_ARGS" | grep -oP '(?<=file_path: ).*?(?=,|$)' || echo "")
if [ -n "$FILE" ] && [[ "$FILE" == *.php ]] && [ -f "$FILE" ]; then
echo "🎨 Auto-formatage PSR-12 de $FILE..."
if [ -f "vendor/bin/php-cs-fixer" ]; then
vendor/bin/php-cs-fixer fix "$FILE" --rules=@PSR12 --quiet 2>/dev/null && echo "✅ Formaté : $FILE" || echo "⚠️ Formatage ignoré"
elif [ -f "Makefile" ] && grep -q "^fix:" Makefile; then
make fix FILES="$FILE" 2>/dev/null || echo "⚠️ Formatage ignoré"
fi
fi
once: false
Objectif
Phase 5 du workflow de développement : implémenter la feature selon le plan généré.
Variables
PATH_TO_PLAN: $ARGUMENTS
Instructions à Exécuter
IMPORTANT : Exécute ce workflow étape par étape :
1. Vérifier le contexte et charger le plan
- Extrais PATH_TO_PLAN depuis $ARGUMENTS
- Si PATH_TO_PLAN n'est pas fourni :
- Lis
.claude/data/.dev-workflow-state.jsonavec Read - Extrais
planPathdu JSON
- Lis
- Si toujours pas de plan, affiche une erreur et arrête
2. Demander approbation avant implémentation
⚠️ CRITIQUE : Ne PAS commencer l'implémentation sans approbation explicite.
Attendre confirmation avant de continuer.
3. Lire le plan
- Lire le fichier plan complet
- Extraire les étapes d'implémentation
- Identifier les fichiers à créer/modifier
4. Implémenter étape par étape
Pour chaque étape du plan :
- Créer une todo pour l'étape
- Lire les fichiers concernés (si modification)
- Implémenter le code
- Respecter :
- Les conventions du projet (CLAUDE.md)
- Les patterns identifiés dans l'exploration
- Les décisions prises en phase 2
- Marquer la todo comme complétée
5. Créer les tests
- Créer les tests unitaires spécifiés dans le plan
- Suivre l'approche TDD si possible
- S'assurer que les tests passent
6. Vérifications qualité
Lancer les vérifications :
make phpstan # PHPStan niveau 9
make fix # Formatage PSR-12
⚠️ Corriger TOUTES les erreurs PHPStan avant de continuer.
7. Mettre à jour le workflow state
8. Rapport
Règles
- Approbation obligatoire avant de commencer
- PHPStan = 0 erreurs (bloquant CI)
- Respecter le plan (pas d'improvisation)
- Tests pour chaque composant
- Conventions françaises pour les variables et documentation
Expert Next.js App Router
Developpement
Un skill qui transforme Claude en expert Next.js App Router.
Générateur de README
Developpement
Crée des README.md professionnels et complets pour vos projets.
Rédacteur de Documentation API
Developpement
Génère de la documentation API complète au format OpenAPI/Swagger.