modern-python

目的

把 Python 仓库收敛到 单一配置源（pyproject.toml）、快的 lint/format（ruff）、快的类型检查（ty）、统一的依赖与虚拟环境（uv），并把同样命令接到本地钩子与 CI，减少「每人一套命令」的摩擦。

不适用

• 仅改一两个文件且无意动工具链。
• 主要任务是业务/产品设计而非工程化（除非用户点名要工程化）。

与 tech-preferences 的关系

本仓库的横切偏好已约定：uv（包与虚拟环境）、ruff（lint + format）、ty（类型检查）、prek（预提交钩子，替代 pre-commit 的常见选型）。本 skill 给出可执行的落地步骤；若与 tech-preferences 冲突，以用户当次指令为准。

Python 版本与新特性

• 默认下限：project.requires-python 宜为 >=3.12（除非用户或上游约束更旧）。
• 尽量用新：在兼容依赖的前提下，本地与 CI 优先使用当前目标范围内的最新稳定小版本（例如下限 3.12 时可用 3.12.x 最新；若项目明确以 3.13 为下限，则用 3.13.x 最新），并与 uv python pin、测试镜像一致。