python-uv

uv 技能提供关于使用 Astral 开发之 uv 工具的专业指引，这是一个以 Rust 编写的高效能 Python 套件与专案管理工具。其速度比传统 pip 工作流程快 10 至 100 倍，使 Claude 能够协助处理从项目初始建立、生产环境 Docker 部署到 CI/CD 管线整合的整个开发生命周期。

• 透过 uv init 简化项目初始化，自动产生包含 pyproject.toml 与 .python-version 档案的标准结构。

• 提供先进的相依性管理工作流程，可进行新增、移除与同步套件，并以单一、高速的接口取代 pip、pip-tools 与 poetry。

• 使用 uv run 进行高效执行，无需手动启用虚拟环境，系统会自动处理环境同步。

• 具备 Python 版本管理功能，允许使用者透过 uv python 指令轻松安装、列出与切换多种 Python 版本。

• 原生工具管理机制，可取代 pipx 在隔离环境中安装、执行与升级如 ruff、black 与 pytest 等 CLI 工具。

• 透过 uv pip 接口保持与旧有系统的兼容性，可直接将现有的 requirements.txt 档案迁移至现代化的 uv 管理结构中。

• 当您需要启动新项目、优化现有相依性链或解决复杂的 Python 环境问题时，请使用此技能。

• 极力推荐用于 CI/CD 设置中，特别是当可重现的构建与锁定版本对生产稳定性至关重要时。

• Claude 可以利用此技能产生最佳化的生产用 Dockerfile，藉由 uv 的高效快取与同步机制，确保映像档体积最小化并缩短建置时间。

• 请一律使用 uv run 来执行指令码与工具，因为这能确保环境实时更新，并避免手动启用 venv 常见的问题。

• 请记住 uv 会透过 uv.lock 档案建立确定性的环境；为了确保项目可携性，请务必将此档案纳入版本控制。

• 当从旧工具进行迁移时，本技能提供明确的工作流程，协助您汇入需求并平顺转换至现代化的 uv 设置。