Designing Python APIs
Design API di librerie Python: denominazione, firme, deprecazione, gestione errori fail-loud.
Promosso
Cosa fa
Guida il design delle API di librerie Python — progressive disclosure, pattern di argomenti keyword-only, gerarchie di eccezioni personalizzate e una checklist dettagliata 'fail loud, not silent' per evitare errori mascherati. Si attiva durante la progettazione di una nuova API di libreria, la revisione di una esistente o la pianificazione di una modifica di deprecazione/versioning; si collega a una skill di gestione del rilascio complementare per la meccanica della deprecazione.
Rapporto di test
Ho eseguito un vero compito di design API (add_task con priority/due/recurring/notify opzionali): la versione della skill ha imposto argomenti keyword-only per eliminare un bug 'boolean-trap' che la baseline aveva spedito così com'era, più una gerarchia di eccezioni personalizzata con suggerimenti invece di una semplice Exception.
Testato il: 2026-07-14 · Claude Code 2.x (agent harness)
Installazione
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
Comandi e prompt di esempio
/designing-python-apisDesign API di librerie Python: denominazione, firme, deprecazione, gestione errori fail-loud.
Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):
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?