CommunityCodierung & Entwicklunggithub.com

sk-python

Schreibe und debugge Python mit Fokus auf Fallstricke, die stilles Fehlverhalten verursachen – veränderliche Defaults, späte Bindung in Closures, flache Kopien, verschluckte Ausnahmen – sowie Typisierung, Umgebung und Paketierung mit uv oder venv und pytest-Struktur. Verwende es beim Schreiben eines Python-Skripts, -Diensts oder -Bibliothek, beim Einrichten eines Python-Projekts oder beim Debuggen von Verhalten, das unmöglich erscheint.

Was ist sk-python?

Diese Fähigkeit ist ein umfassender Leitfaden für Python-Entwicklung, der Entwicklern hilft, häufige, aber schwer zu erkennende Fallstricke zu vermeiden, die zu stillem Fehlverhalten führen. Sie behandelt kritische Themen wie veränderliche Standardargumente, späte Bindung in Closures, die korrekte Verwendung von `is` vs. `==`, flache Kopien, das Abfangen von Ausnahmen sowie Fallstricke bei Integer-Division und Float-Vergleichen. Zusätzlich bietet sie praktische Anleitung zur Einrichtung von Python-Umgebungen und Paketierung, wobei virtuelle Umgebungen (venv oder uv) und die Verwendung von `pyproject.toml` mit einer Sperrdatei zur Reproduzierbarkeit empfohlen werden. Die Fähigkeit betont auch die Bedeutung von Typhinweisen an Funktionsschnittstellen, die Ausführung von Typprüfern in der CI sowie Best Practices für Datenstrukturen wie `dataclass` und Validierungsmodelle. Darüber hinaus enthält sie einen Abschnitt zu wichtigen Sprachidiomen (Comprehensions, `pathlib.Path`, Kontextmanager, `enumerate`/`zip`) und eine Anleitung zur Teststrukturierung mit `pytest`, inklusive parametrisierter Tests und korrekter Fixture-Verwaltung. Für die Leistungsoptimierung rät sie zu Messungen mit `time.perf_counter`/`cProfile` und skizziert Strategien für I/O-gebundene (asyncio, Threads) und CPU-gebundene nebenläufige Aufgaben (Prozesse).

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/vanhuydotcom/sk-skills/tree/HEAD/skills/sk-python

Installed? Explore more Codierung & Entwicklung skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Python

Python ist einfach zu schreiben und leicht auf subtile Weise falsch. Dies deckt die Fallstricke ab, die stillschweigend fehlschlagen, sowie das Projekt-Setup, das eine fehlerhafte Umgebung vermeidet.

Fallstricke, die stillschweigend fehlschlagen

Veränderliche Standardargumente werden einmalig bei der Definition ausgewertet und von jedem Aufruf gemeinsam genutzt:

def add(item, bucket=[]):   # falsch: bucket bleibt über Aufrufe hinweg erhalten
def add(item, bucket=None): # richtig
    bucket = [] if bucket is None else bucket

Closures binden spät. Ein Lambda, das in einer Schleife erstellt wird, erfasst die Variable, nicht ihren Wert, sodass jedes Lambda den endgültigen Wert sieht. Binde es explizit mit einem Standardargument oder verwende functools.partial.

is prüft Identität, nicht Gleichheit. Es funktioniert für None, True und False – und sonst für nichts. Es scheint für kleine Integer und kurze Strings zu funktionieren, weil diese interiert werden, was genau der Grund ist, warum der Fehler das Testen überlebt.

Kopien sind flach. list(xs), xs[:] und dict(d) kopieren den Container und teilen die Elemente. Verschachtelte Strukturen benötigen copy.deepcopy.

Ein bloßes except: fängt alles, einschließlich KeyboardInterrupt und SystemExit. Fange die spezifische Ausnahme ab und schreibe niemals except Exception: pass – wenn sie wirklich ignorierbar ist, protokolliere sie und erkläre warum.

Ganzzahldivision und Float-Gleichheit. / erzeugt immer einen Float; // rundet gegen negativ unendlich, daher ist -7 // 2 gleich -4. Vergleiche Floats niemals mit ==; verwende math.isclose oder Decimal für Geldbeträge.

Das Durchlaufen einer Sammlung während ihrer Mutation überspringt Elemente. Erstelle eine neue Liste oder iteriere über eine Kopie.

Generatoren werden einmal verbraucht. Ein zweiter Durchlauf über denselben Generator liefert nichts, was als leeres Ergebnis und nicht als Fehler erscheint.

Umgebung und Paketierung

Installiere niemals in den Systeminterpreter. Erstelle pro Projekt eine virtuelle Umgebung und aktiviere sie oder lasse uv die Verwaltung übernehmen:

uv venv && uv pip install -e ".[dev]"     # oder: python -m venv .venv

Deklariere Abhängigkeiten in pyproject.toml und committe eine Sperrdatei, damit die Umgebung reproduzierbar ist. Eine requirements.txt ohne festgelegte Versionen ist nicht reproduzierbar und wird auf einem zukünftigen Rechner brechen.

Lege die Python-Version fest, die das Projekt unterstützt, und gib sie in pyproject.toml an. Das Verhalten unterscheidet sich zwischen Nebenversionen mehr, als man erwartet.

Wenn ein Import an einer Stelle funktioniert und an einer anderen nicht, liegt die Ursache fast immer am Interpreter und nicht am Code. Überprüfe which python und python -c "import sys; print(sys.executable)", bevor du den Import debuggst.

Typen

Kommentiere Funktionssignaturen – Parameter und Rückgabetyp. Der Rumpf benötigt selten Anmerkungen; die Grenze jedoch immer, denn darauf verlässt sich anderer Code.

Führe einen Typprüfer in der CI aus. Anmerkungen, die von nichts überprüft werden, veralten und werden zu irreführender Dokumentation.

Verwende X | None anstelle einer bloßen optional-ohne-Kennzeichnung und mache die Optionalität in der Signatur sichtbar. Bevorzuge spezifische Typen gegenüber Any; wenn der Typ wirklich unbekannt ist, verwende das Äquivalent von unknown – object – und grenze es ein, sodass der Prüfer die Eingrenzung erzwingt.

Für strukturierte Daten bevorzuge ein dataclass oder ein validierendes Modell an der Grenze, wo Daten von außen ankommen. Ein Wörterbuch von Strings, das zwischen Funktionen übergeben wird, verliert jede Garantie beim ersten Tippfehler.

Wichtige Redewendungen

Verwende eine Comprehension, wenn sie abbildet oder filtert, und eine Schleife, wenn sie etwas anderes tut. Eine Comprehension mit einem Seiteneffekt oder drei Klauseln ist schwerer zu lesen als die Schleife, die sie ersetzt.

Verwende pathlib.Path anstelle von String-Pfaden und einen Kontextmanager für alles, was geschlossen werden muss – Dateien, Verbindungen, Sperren, temporäre Verzeichnisse.

Verwende yield from in einem Generator, anstatt eine Liste zu erstellen, wenn die Eingabe groß oder unbegrenzt ist; das ist der Unterschied zwischen einem Skript, das streamt, und einem, das den Speicher erschöpft.

Verwende enumerate, zip und dict.get mit einem Standardwert anstelle von Indexarithmetik und Mitgliedschaftsprüfungen. Sie sind schneller und vermeiden eine Klasse von Off-by-One-Fehlern.

Tests

pytest mit einfachem assert. Verwende @pytest.mark.parametrize für tabellengesteuerte Fälle anstelle einer Schleife innerhalb eines Tests, damit jeder Fall separat gemeldet wird.

Lege gemeinsame Einrichtung in eine Fixtur mit dem engsten gültigen Geltungsbereich. Eine session-weite Fixtur, die veränderlichen Zustand hält, tritt zwischen Tests aus und erzeugt reihenfolgeabhängige Fehler.

Fange die spezifische Ausnahme mit pytest.raises ab, einschließlich der Nachricht, wenn sie wichtig ist.

Leistung, wenn sie zählt

Messe vor der Optimierung – time.perf_counter für einen groben Wert, cProfile für die Details.

Der übliche Gewinn besteht darin, Arbeit aus dem Interpreter zu verlagern: ein Built-in, eine Comprehension, str.join anstelle wiederholter Verkettung, eine set- oder dict-Suche anstelle des Durchscannens einer Liste, oder ein vektorisierter Bibliotheksaufruf für numerische Arbeit.

Für I/O-gebundene Nebenläufigkeit verwende asyncio oder Threads; für CPU-gebundene Arbeit verwende Prozesse, da die globale Interpretersperre (GIL) bedeutet, dass Threads nicht helfen werden.

Individual skills in this repo

This repo contains 5 individual skills — each has its own dedicated page.

sk-api

Design and change API contracts (REST, gRPC, protobuf, events) so existing callers keep working, covering resource and method shape, error models, pagination, versioning and the deploy order a breaking change requires. Use when adding or altering an endpoint, message or event, or when judging whether a proposed change breaks a consumer.

sk-code-review

Shows an agent how to design, debug, or review "sk code review" so the concrete output is a code change with a check. The procedure moves through Code review, Establish the diff first, What to look for, in priority order. Use it when a new assignment calls for this craft.

sk-go-service

Implement, extend or debug a handler, service or repository in a Go backend service, covering context propagation, error wrapping, transaction boundaries, tenancy scoping and table-driven tests. Use when writing or changing Go server code, adding an endpoint or gRPC method, touching a repository query, or diagnosing a panic, leak or flaky test in a Go service.

sk-react

Build and fix React and TypeScript components, covering state placement, effect dependencies, data fetching, list rendering and the re-render traps that cause stale or looping UI. Use when writing or changing a React component or hook, debugging stale data, an infinite render loop or a lost input, or reviewing frontend code.

sk-system-design

Design or evaluate a distributed system from its constraints — service boundaries, synchronous versus event-driven communication, consistency, failure behaviour and capacity — and state the trade-off each choice buys. Use when splitting or merging services, choosing between a call and an event, deciding where data lives, reviewing an architecture proposal, or answering a system design question.

Verwandte Skills