用途：帮助在 Python 项目中利用类型系统，在静态分析阶段发现错误。类型注解被视为可被工具自动校验的强制文档。
适用时机：为现有代码添加类型提示；创建可复用的泛型类；用 Protocol 定义结构化接口；为 mypy 或 pyright 配置严格检查；理解类型收窄与类型守卫；构建类型安全的 API 与库。
核心概念：类型注解为函数参数、返回值与变量声明预期类型；泛型在复用代码中保留类型信息；Protocol 无需继承即可定义结构化接口；类型收窄借助守卫与条件在代码块内缩小类型范围。
常用做法：为全部公开签名标注类型；使用 User | None 等形式显式表达可能缺失，并在处理 None 分支后让类型检查器收窄类型；在 CI 中运行 mypy --strict 或 pyright；通过 per-module overrides 逐步启用严格模式；泛型类型变量可加 bound 约束；用类型别名命名复杂类型；尽量减少 Any。
限制：属于指导性技能，不直接产出具体代码实现，需要项目上下文与技术栈信息；非技术业务决策不在范围内。详细模式与示例存放于 references/details.md。未提供安装命令、具体收费标准与平台支持信息。