Compétence : Normes de codage Python dignes
Normes de codage Python de qualité production pour écrire un code Python propre, maintenable et moderne (versions 3.10-3.13).
Quand utiliser cette compétence
Auto-invocation lorsque les utilisateurs demandent :
- « rends ce code pythonique » / « est-ce que c'est du bon Python »
- « indications de type » / « annotations de type » / « typage »
- « LBYL vs EAFP » / « gestion d'exceptions »
- « pathlib vs os.path » / « opérations sur les chemins »
- « patterns CLI » / « utilisation de click »
- « revue de code » / « améliore ce code »
- Toute question sur la qualité ou les normes du code Python
Remarque : Cette compétence concerne les normes Python générales, pas spécifiques à Dagster. Utilisez
/dagster-expert pour les patterns Dagster.
Quand utiliser cette compétence vs. d'autres
| Besoin utilisateur | Utiliser cette compétence | Compétence alternative |
|---|---|---|
| « rends ce code pythonique » | ✅ Oui - normes Python | |
| « est-ce que c'est du bon Python » | ✅ Oui - qualité de code | |
| « indications de type » | ✅ Oui - conseils de typage | |
| « LBYL vs EAFP » | ✅ Oui - patterns d'exception | |
| « pathlib vs os.path » | ✅ Oui - gestion des chemins | |
| « patterns spécifiques à Dagster » | ❌ Non | /dagster-expert |
| « analyse d'arguments CLI » | ✅ Oui - patterns CLI |
Connaissances de base (TOUJOURS chargées)
Détection de version
Identifier la version minimale de Python du projet en vérifiant (dans l'ordre) :
pyproject.toml- Chercher le champrequires-python(ex.requires-python = ">=3.12")setup.pyousetup.cfg- Chercherpython_requires- Fichier
.python-version- Contient la version comme3.12ou3.12.0 - Par défaut, Python 3.12 si aucun spécificateur de version n'est trouvé
Une fois identifiée, charger le fichier spécifique à la version :
- Python 3.10 : Charger
versions/python-3.10.md - Python 3.11 : Charger
versions/python-3.11.md - Python 3.12 : Charger
versions/python-3.12.md - Python 3.13 : Charger
versions/python-3.13.md
Chargement conditionnel (charger selon les motifs de la tâche)
Les fichiers de base ci-dessus couvrent 80 %+ des patterns de code Python. Chargez ces fichiers supplémentaires uniquement lorsque vous détectez des motifs spécifiques :
Exemples de détection de motifs :
- Si la tâche mentionne « click » ou « CLI » -> Charger
cli-patterns.md - Si la tâche mentionne « subprocess » -> Charger
subprocess.md
Structure de la documentation de référence
Les documents de référence sont organisés dans des fichiers de premier niveau et des sous-répertoires :
Références principales (à côté de SKILL.md)
dignified-python-core.md- Normes essentielles (toujours chargées)cli-patterns.md- Patterns d'interface en ligne de commande (click, argparse)subprocess.md- Opérations de sous-processus
Références spécifiques à une version (versions/)
versions/python-3.10.md- Fonctionnalités disponibles dans Python 3.10+versions/python-3.11.md- Fonctionnalités disponibles dans Python 3.11+versions/python-3.12.md- Fonctionnalités disponibles dans Python 3.12+versions/python-3.13.md- Fonctionnalités disponibles dans Python 3.13+
Sujets avancés (references/advanced/)
exception-handling.md- Patterns LBYL, limites d'erreurinterfaces.md- Patterns ABC et Protocoltyping-advanced.md- Patterns de typage avancésapi-design.md- Principes de conception d'API
Quand lire chaque document de référence
references/advanced/exception-handling.md
Lire quand :
- Écrire des blocs try/except
- Encapsuler des API tierces susceptibles de lever des exceptions
- Voir ou écrire
from eoufrom None - Ne pas savoir si une alternative LBYL existe
references/advanced/interfaces.md
Lire quand :
- Créer des classes ABC ou Protocol
- Écrire des décorateurs @abstractmethod
- Concevoir des interfaces de couche de passerelle
- Choisir entre ABC et Protocol
references/advanced/typing-advanced.md
Lire quand :
- Utiliser typing.cast()
- Créer des alias de type Literal
- Rétrécir les types dans les blocs conditionnels
references/module-design.md
Lire quand :
- Créer de nouveaux modules Python
- Ajouter du code au niveau du module (au-delà de constantes simples)
- Utiliser le décorateur @cache au niveau du module
- Voir Path() ou des calculs au niveau du module
- Envisager des importations inline
references/api-design.md
Lire quand :
- Ajouter des valeurs de paramètres par défaut aux fonctions
- Définir des fonctions avec 5 paramètres ou plus
- Utiliser ThreadPoolExecutor.submit()
- Réviser les signatures de fonctions
references/checklists.md
Lire quand :
- Faire une revue finale avant de valider du code Python
- Ne pas savoir si vous avez suivi toutes les règles
- Avoir besoin d'une consultation rapide des exigences
Comment utiliser cette compétence
- Connaissances de base chargées automatiquement (LBYL, pathlib, importations de base, anti-patrons)
- Détection de version effectuée une fois - identifier la version minimale de Python et charger le fichier de version approprié
- Documents de référence chargés à la demande selon les déclencheurs ci-dessus
- Patterns supplémentaires peuvent nécessiter un chargement supplémentaire (patterns CLI, sous-processus)
- Chaque fichier est autonome avec des conseils complets pour son domaine