Python Code Review with Modern Typing

此技能作为专门的代码审查代理，专注于执行严格的 Python 类型安全。它专为旨在通过采用 Python 3.12+ 类型注解惯例来现代化其 Python 代码库的开发人员、软件工程师和自动化 CI 管线而设计。主要目标是消除函数签名、类属性和变量声明中的模糊性，减少因类型不匹配而导致的运行时错误，并改善 IDE 自动完成和静态分析性能。

• 系统化审查函数签名，确保所有参数和返回类型都已明确注解。

• 强制执行现代内置泛型类型，将旧有的 typing 模块导入（如 List、Dict、Set 和 Tuple）替换为原生的全小写替代方案。

• 将联合与可选类型转换为现代语法，特别是使用 | 运算符处理联合，以及使用 X | None 处理可选值。

• 验证复杂类属性类型和内联变量注解，以确保全面的类型覆盖。

• 与静态分析工具（如 mypy）集成，特别支持 pyproject.toml 中的 --strict 设置。

• 识别已弃用的 typing 模块模式，以防止技术债并确保代码具备未来扩展性。

• 非常适合在提取请求 (Pull Request) 审查、重构期间或作为合并前检查使用，以验证类型完整性。

• 输入需求包含原始 Python 代码或待审查的文件路径；该技能会根据当前的类型标准生成具体的修正建议。

• 它优先考虑严格遵守 PEP 标准，特别针对移除旧有的类型构造，转而采用 Python 近期版本中引入的语言原生泛型语法。

• 请注意，此技能刻意忽略高阶架构或性能逻辑，仅专注于类型声明的精确度，以建立稳健的代码契约。