Directives Python

VérifiéSûr

Applique des conventions de code Python : imports en haut du fichier, underscores pour les grands nombres, contenu minimal dans __init__.py, paramètres nommés obligatoires pour les fonctions avec plusieurs paramètres, et paramètres requis sans valeurs par défaut superflues. Utile pour améliorer la lisibilité et la cohérence du code Python.

Spar Skills Guide Bot
DeveloppementIntermédiaire
12002/06/2026
Claude CodeCursorWindsurfCopilotCodex
#python#coding-style#best-practices#imports#formatting

Recommandé pour

Notre avis

Ce skill fournit des lignes directrices pour écrire du code Python propre et cohérent, en mettant l'accent sur les imports, le formatage et la définition de paramètres.

Points forts

  • Encourage l'utilisation d'imports en haut du fichier
  • Utilise des underscores pour les grands nombres
  • Impose des paramètres nommés pour les fonctions
  • Interdit le remplissage inutile des __init__.py

Limites

  • Ne couvre pas les conventions de nommage (PEP8)
  • Peut être trop restrictif pour certains projets
  • Ne traite pas des annotations de type
Quand l'utiliser

Utilisez ce skill lorsque vous créez ou modifiez du code Python et souhaitez suivre des conventions de style strictes et claires.

Quand l'éviter

Évitez ce skill si vous travaillez sur un projet avec son propre guide de style ou si la flexibilité est préférée.

Analyse de sécurité

Sûr
Score qualité85/100

This skill contains only Python style and code organization guidelines. There are no executable commands, destructive operations, or any instructions that could pose a security risk.

Aucun point d'attention détecté

Exemples

Create a new Python module
Create a new Python file called utils.py. Ensure imports are at the top, use keyword-only arguments for any functions with more than one parameter, and do not add anything to __init__.py.
Refactor existing Python code
Refactor the following Python code to follow best practices: move all imports to the top, enforce keyword arguments in functions with multiple parameters, and use underscores for large numbers where applicable.
Add a function with parameters
Add a function `calculate_tax(*, income: float, rate: float) -> float` that computes tax. Make sure all parameters are keyword-only and required.

name: python description: Guidelines when creating, reading, updating, or deleting Python code

Python Guidelines

Instructions

imports

Imports should ALWAYS be at the top of the file. NEVER have local imports unless it is 100% necessary.

formatting

For big numbers, use _ to make numbers more clear BAD: foo = 1000 GOOD: foo = 1_000

init.py files

Do not add anything inside of __init__.py files unless it is absolutely necessary or you are explicitly asked to. This includes adding __all__; NEVER add that.

function parameters

Functions with more than 1 parameter should ALWAYS use * to enforce keyword arguments. BAD: def foo(a, b, c): ... GOOD: def foo(*, a, b, c): ... Functions should always use required parameters unless making a parameter optional is absolutely necessary. Functions should not set defaults for parameters unless it is an EXTREMELY sane default.

Skills similaires