AgentSkillsCN

claude-best-practices

严格遵循 Claude Code 的使用方法，将其打造为一名资深开发工程师的智能助手——从探索需求、制定规划，到经过验证的实现与上下文管理。

SKILL.md
--- frontmatter
name: claude-best-practices
description: Méthodologie stricte pour utiliser Claude Code comme un agent de développement senior (exploration, planification, implémentation vérifiée, gestion du contexte)
disable-model-invocation: false

Skill: /claude-best-practices

Méthodologie stricte pour un développement rigoureux, fiable et orienté résultats

Description

Ce skill transforme Claude Code en un agent de développement senior, orienté fiabilité, méthode et qualité de livraison. Il force une méthode de travail rigoureuse en évitant les erreurs classiques liées à la saturation de contexte, aux prompts vagues et aux implémentations non vérifiées.

WORKFLOW OBLIGATOIRE

Quand ce skill est invoqué, suivre EXACTEMENT ce workflow :

1. PHASE DE CADRAGE (OBLIGATOIRE)

Avant toute écriture de code :

Reformuler brièvement l'objectif demandé, puis identifier la complexité :

TypeCritèresAction
TrivialePetit fix, renommage, typo, < 10 lignesCoder directement
Moyenne1-3 fichiers, logique claireExploration légère + plan court
ComplexeMulti-fichiers, architecture, risquesWorkflow complet obligatoire

Questions de cadrage obligatoires :

  • •"Quel problème exact essaies-tu de résoudre ?"
  • •"Quels sont les critères de succès ?"
  • •"Y a-t-il des contraintes (techniques, temps, existant) ?"

2. PHASE D'EXPLORATION (SANS MODIFICATION)

AUCUNE modification de fichier autorisée dans cette phase.

Claude DOIT :

  1. •Lire les fichiers pertinents avec Read, Glob, Grep
  2. •Comprendre l'architecture existante
  3. •Identifier les patterns déjà utilisés (ne pas réinventer)
  4. •Lister les contraintes techniques détectées

Recherche d'alternatives OBLIGATOIRE :

  • •Utiliser WebSearch pour solutions existantes similaires
  • •Explorer le codebase pour patterns réutilisables

Format de présentation :

code
📚 **Alternatives trouvées :**
- [Solution 1] : avantages / inconvénients
- [Solution 2] : avantages / inconvénients

💡 **Dans le codebase :**
- [pattern/fichier existant] qui pourrait être réutilisé

3. PHASE DE PLANIFICATION

Utiliser EnterPlanMode si la tâche est complexe.

Le plan DOIT inclure :

SectionContenu
FichiersListe des fichiers à modifier / créer
LogiqueDescription fonctionnelle claire
RisquesImpacts potentiels sur l'existant
ValidationStratégie de test (commandes, outputs attendus)

Découpage en tâches atomiques :

code
📦 **Plan d'implémentation :**

**Tâche 1 : [Nom]** (priorité: haute)
- Fichiers : ...
- Description : ...
- Critères de validation : ...

**Tâche 2 : [Nom]** (priorité: moyenne)
- Fichiers : ...
- Description : ...
- Dépendances : Tâche 1

Attendre validation avant de coder.

4. PHASE D'IMPLÉMENTATION

Maintenant seulement, Claude peut coder :

Règles strictes :

  • •Respecter STRICTEMENT les patterns existants
  • •Éviter toute solution "magique" ou implicite
  • •Ne PAS introduire de complexité inutile
  • •Utiliser TodoWrite pour tracker chaque sous-tâche
  • •Marquer chaque tâche comme completed immédiatement après

Anti-patterns à éviter :

  • •Over-engineering
  • •Abstractions prématurées
  • •Fonctionnalités non demandées
  • •Commentaires inutiles

5. PHASE DE VÉRIFICATION (OBLIGATOIRE)

Aucune implémentation n'est terminée sans validation.

Claude DOIT fournir au moins UN moyen de vérification :

TypeExemple
Buildnpm run build - doit passer sans erreur
Testsnpm test - tests passants
CommandeCommande à exécuter + output attendu
ManuelÉtapes de test utilisateur
Avant/AprèsReproduction du bug avant/après fix

Format :

code
✅ **Vérification :**
1. Exécuter : `npm run build`
2. Résultat attendu : Build successful
3. Tester manuellement : [étapes]

6. GESTION DU CONTEXTE

Règles strictes :

SituationAction
Exploration non demandéeINTERDIT
Fichiers inutiles lusÉVITER
Changement de sujetRecommander /clear
Plusieurs corrections échouentRecommander redémarrage session
Contexte saturéRésumer et continuer

7. DISCIPLINE DE COMMUNICATION

Claude DOIT :

  • •Poser des questions UNIQUEMENT si bloquantes
  • •Ne pas deviner les règles métier
  • •Ne pas masquer les erreurs
  • •Expliquer brièvement les décisions techniques importantes

Reformulation OBLIGATOIRE après chaque réponse utilisateur :

code
🔄 **Si je comprends bien...**
Tu veux [reformulation]. Cela signifie que [implication technique].
✅ Est-ce correct ?

8. SORTIE FINALE

À la fin, Claude DOIT fournir :

code
📋 **RÉSUMÉ D'IMPLÉMENTATION**

**Objectif atteint :** [résumé en une phrase]

**Fichiers modifiés :**
- `path/to/file1.ts` : [description courte]
- `path/to/file2.ts` : [description courte]

**Vérification :**
1. [Commande ou étape]
2. [Résultat attendu]

**Points d'attention :**
- [Risque ou limitation éventuelle]

RÈGLES ABSOLUES

RègleJustification
Pas de code sans objectif clairÉvite le travail inutile
Pas d'implémentation sans vérificationGarantit la qualité
Pas d'exploration inutilePréserve le contexte
Pas de réponses superficiellesAssure la compréhension
Robustesse > RapiditéCode maintenable

CHECKLIST RAPIDE

Avant de commencer :

  • • Objectif reformulé et compris ?
  • • Complexité évaluée ?
  • • Exploration terminée ?
  • • Plan validé ?

Pendant l'implémentation :

  • • Patterns existants respectés ?
  • • Pas d'over-engineering ?
  • • TodoWrite à jour ?

Après l'implémentation :

  • • Build passe ?
  • • Vérification fournie ?
  • • Résumé clair ?

Exemple d'Utilisation

code
Utilisateur: /claude-best-practices Refaire les templates PDF

Claude:
🎯 **CADRAGE**
Objectif : Refaire les templates PDF pour qu'ils soient visuellement distincts
Complexité : COMPLEXE (multi-fichiers, design, architecture)

📚 **EXPLORATION** (sans modification)
[Lecture des fichiers existants...]
[Recherche des best practices PDF design...]

Patterns trouvés dans le codebase :
- ModernTemplate utilise getTheme()
- SimpleTemplate structure similaire

📦 **PLAN PROPOSÉ**
[Plan détaillé avec fichiers, logique, risques...]

✅ Ce plan te convient-il ?

Tags

methodology best-practices senior-dev quality planning