Designing Python APIs

Projektowanie API bibliotek Python: nazewnictwo, sygnatury, wycofywanie, głośne obsługiwanie błędów.

Testowano · Działa ★ 9.2/10

Co robi ten skill

Prowadzi projektowanie API bibliotek Python — progresywne ujawnianie, wzorce argumentów tylko-słowo-kluczowe, niestandardowe hierarchie wyjątków i szczegółowa lista kontrolna 'fail loud, not silent' w celu unikania maskowanych błędów. Uruchamia się podczas projektowania nowego API biblioteki, przeglądania istniejącego lub planowania zmiany wycofania/wersjonowania; odsyła do towarzyszącej umiejętności zarządzania wydaniami w celu mechaniki wycofywania.

Raport z testu

Uruchomiono rzeczywiste zadanie projektowania API (add_task z opcjonalnymi priority/due/recurring/notify): wersja umiejętności wymusiła argumenty tylko-słowo-kluczowe, aby wyeliminować błąd pułapki boolean, który bazowa wersja dostarczyła w niezmienionej formie, plus niestandardową hierarchię wyjątków z podpowiedziami zamiast gołego Exception.

Testowano: 2026-07-14 · Claude Code 2.x (agent harness)

Instalacja

git clone https://github.com/wdm0006/python-skills
cd python-skills
mkdir -p ~/.claude/skills
cp -r skills/python/api-design ~/.claude/skills/designing-python-apis

Komendy i przykładowe prompty

/designing-python-apisProjektowanie API bibliotek Python: nazewnictwo, sygnatury, wycofywanie, głośne obsługiwanie błędów.

Skille uruchamiają się na zwykłe polecenia — bez komend do zapamiętania. Po instalacji aktywują go prompty takie jak te (po angielsku):

Help me design the public API for a new Python caching library.
Review this library's function signatures before we hit v1.0.
How should I deprecate a parameter without breaking callers?

Pełny raport →