Designing Python APIs

Návrh API Python knihoven: pojmenování, signatury, zastarání, hlasité zpracování chyb.

Otestováno · Funguje ★ 9.2/10

Co umí

Vede návrh API Python knihoven — progresivní odhalování, vzory argumentů pouze s klíčovými slovy, vlastní hierarchie výjimek a podrobný kontrolní seznam 'fail loud, not silent' pro zamezení maskovaných chyb. Spouští se při návrhu nového API knihovny, revizi existujícího nebo plánování změny zastarání/verze; odkazuje na doprovodnou dovednost pro správu vydání pro mechaniku zastarání.

Testovací report

Spustil jsem skutečný úkol návrhu API (add_task s volitelnými priority/due/recurring/notify): verze dovednosti vynutila argumenty pouze s klíčovými slovy, aby odstranila chybu boolean-trap, kterou baseline dodávala tak, jak je, plus vlastní hierarchii výjimek s nápovědami namísto holé výjimky.

Testováno: 2026-07-14 · Claude Code 2.x (agent harness)

Instalace

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

Příkazy a ukázkové prompty

/designing-python-apisNávrh API Python knihoven: pojmenování, signatury, zastarání, hlasité zpracování chyb.

Skilly se spouštějí běžnými požadavky — žádné příkazy k zapamatování. Po instalaci ho aktivují prompty jako tyto (anglicky):

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?

Kompletní testovací report (anglicky) →