python-type-hints-guide

SKILL.md

This skill provides comprehensive guidance on Python type hints and static type checking for Python 3.9+ codebases. It serves as a reference during code reviews to ensure proper type annotation usage, evaluate type hint quality, and promote best practices for gradual typing adoption.

This skill should be referenced by the uncle-duke-python agent when:

Type hints (introduced in PEP 484) enable static type checking in Python while maintaining the language's dynamic nature. Modern Python (3.9+) has significantly improved type hint syntax with built-in generic types and the union operator. Proper type hints improve:

Python 類型提示的綜合參考指南、使用 mypy 進行靜態類型檢查、現代類型註釋模式（PEP 484、585、604、612、613）以及 Python 3.9+ 的類型提示最佳實踐。在代碼審查期間使用，以確保正確使用類型註釋、評估 mypy 配置並識別類型提示反模式。 來源：clostaunau/holiday-card。

查看原文