Skill für Würdevolle Python-Codierungsstandards
Produktionsreife Python-Codierungsstandards zum Schreiben von sauberem, wartbarem, modernem Python-Code (Versionen 3.10–3.13).
Wann Diese Skill Verwenden
Automatisch aufrufen, wenn Benutzer fragen nach:
- "mach das pythonischer" / "ist das gutes Python"
- "Type Hints" / "Typannotationen" / "Typisierung"
- "LBYL vs EAFP" / "Ausnahmebehandlung"
- "pathlib vs os.path" / "Pfadoperationen"
- "CLI-Muster" / "click Verwendung"
- "Code-Review" / "verbessere diesen Code"
- Jegliche Python-Codequalitäts- oder Standardfragen
Hinweis: Diese Skill ist allgemeine Python-Standards, nicht Dagster-spezifisch. Verwenden Sie /dagster-expert für Dagster-Muster.
Wann Diese Skill vs. Andere Verwenden
| Benutzeranliegen | Diese Skill Verwenden | Alternative Skill |
|---|---|---|
| "mach das pythonischer" | ✅ Ja – Python-Standards | |
| "ist das gutes Python" | ✅ Ja – Codequalität | |
| "Type Hints" | ✅ Ja – Typisierungsanleitung | |
| "LBYL vs EAFP" | ✅ Ja – Ausnahmemuster | |
| "pathlib vs os.path" | ✅ Ja – Pfadbehandlung | |
| "Dagster-spezifische Muster" | ❌ Nein | /dagster-expert |
| "CLI-Argument-Parsing" | ✅ Ja – CLI-Muster |
Kernwissen (IMMER Geladen)
Versionserkennung
Ermitteln Sie die minimale Python-Version des Projekts, indem Sie (in dieser Reihenfolge) prüfen:
pyproject.toml– Suchen nach dem Feldrequires-python(z. B.requires-python = ">=3.12")setup.pyodersetup.cfg– Suchen nachpython_requires.python-version-Datei – Enthält Version wie3.12oder3.12.0- Standardmäßig Python 3.12, wenn kein Versionsspezifizierer gefunden wird
Sobald identifiziert, laden Sie die entsprechende versionsspezifische Datei:
- Python 3.10: Laden
versions/python-3.10.md - Python 3.11: Laden
versions/python-3.11.md - Python 3.12: Laden
versions/python-3.12.md - Python 3.13: Laden
versions/python-3.13.md
Bedingtes Laden (Laden Basierend auf Aufgabenmustern)
Die Kern-Dateien decken über 80 % der Python-Code-Muster ab. Laden Sie diese zusätzlichen Dateien nur, wenn Sie bestimmte Muster erkennen:
Beispiele für Mustererkennung:
- Wenn die Aufgabe "click" oder "CLI" erwähnt -> Laden
cli-patterns.md - Wenn die Aufgabe "subprocess" erwähnt -> Laden
subprocess.md
Struktur der Referenzdokumentation
Referenzdokumente sind über Dateien auf oberster Ebene und Unterverzeichnisse organisiert:
Kernreferenzen (neben SKILL.md)
dignified-python-core.md– Grundlegende Standards (immer geladen)cli-patterns.md– Muster für die Befehlszeilenschnittstelle (click, argparse)subprocess.md– Subprocess-Operationen
Versionsspezifische Referenzen (versions/)
versions/python-3.10.md– Funktionen verfügbar ab Python 3.10+versions/python-3.11.md– Funktionen verfügbar ab Python 3.11+versions/python-3.12.md– Funktionen verfügbar ab Python 3.12+versions/python-3.13.md– Funktionen verfügbar ab Python 3.13+
Fortgeschrittene Themen (references/advanced/)
exception-handling.md– LBYL-Muster, Fehlergrenzeninterfaces.md– ABC- und Protocol-Mustertyping-advanced.md– Fortgeschrittene Typisierungsmusterapi-design.md– API-Design-Prinzipien
Wann Jedes Referenzdokument Lesen
references/advanced/exception-handling.md
Lesen, wenn:
- Sie try/except-Blöcke schreiben
- Sie Drittanbieter-APIs umschließen, die Ausnahmen auslösen können
- Sie
from eoderfrom Nonesehen oder schreiben - Sie unsicher sind, ob eine LBYL-Alternative existiert
references/advanced/interfaces.md
Lesen, wenn:
- Sie ABC- oder Protocol-Klassen erstellen
- Sie @abstractmethod-Dekorateure schreiben
- Sie Gateway-Schicht-Schnittstellen entwerfen
- Sie zwischen ABC und Protocol wählen
references/advanced/typing-advanced.md
Lesen, wenn:
- Sie typing.cast() verwenden
- Sie Literal-Typ-Aliasnamen erstellen
- Sie Typen in bedingten Blöcken eingrenzen
references/module-design.md
Lesen, wenn:
- Sie neue Python-Module erstellen
- Sie Code auf Modulebene hinzufügen (über einfache Konstanten hinaus)
- Sie den @cache-Dekorateur auf Modulebene verwenden
- Sie Path() oder Berechnungen auf Modulebene sehen
- Sie Inline-Imports in Betracht ziehen
references/api-design.md
Lesen, wenn:
- Sie Standardparameterwerte zu Funktionen hinzufügen
- Sie Funktionen mit 5 oder mehr Parametern definieren
- Sie ThreadPoolExecutor.submit() verwenden
- Sie Funktionssignaturen überprüfen
references/checklists.md
Lesen, wenn:
- Sie die endgültige Überprüfung vor dem Commit von Python-Code durchführen
- Sie unsicher sind, ob Sie alle Regeln befolgt haben
- Sie eine schnelle Nachschlagemöglichkeit der Anforderungen benötigen
So Verwenden Sie Diese Skill
- Kernwissen wird automatisch geladen (LBYL, pathlib, grundlegende Importe, Anti-Patterns)
- Versionserkennung erfolgt einmal – identifizieren Sie die minimale Python-Version und laden Sie die entsprechende Versionsdatei
- Referenzdokumente werden bei Bedarf basierend auf den obigen Auslösern geladen
- Zusätzliche Muster erfordern möglicherweise zusätzliches Laden (CLI-Muster, subprocess)
- Jede Datei ist in sich abgeschlossen mit vollständiger Anleitung für ihren Bereich