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。

查看原文