Prioritize uv

⚡ 极速 Python 工具链,uv 优先

强制 Claude Code 在所有 Python 任务中优先使用 uv 替代 pip,显著提升依赖安装与虚拟环境管理效率。

收藏
3.6k
安装
1.1k
版本
1.0.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

UV Priority 是一个行为引导型技能,旨在让 Claude Code 在所有涉及 Python 的场景下默认使用 Astral 公司开发的 uv 工具,而非传统的 pip/venv。该技能通过明确的指令替换表,将常见的 Python 命令映射到 uv 等效命令:

| 原命令 | uv 替代 |
|--------|---------|
| `pip install` | `uv add` 或 `uv pip install` |
| `python -m venv` | `uv venv` |
| `python script.py` | `uv run script.py` |
| `pytest` / `python -m pytest` | `uv run pytest` |
| `pip list` / `pip freeze` | `uv pip list` / `uv pip freeze` |

显著优点

1. 极速性能uv 采用 Rust 编写,依赖解析和安装速度比 pip 快 10-100 倍,大幅提升开发迭代效率
2. 统一工具链:将 pipvenvpip-toolsvirtualenv 功能整合为单一工具,减少认知负担

3. 原生 `pyproject.toml` 支持:无缝对接现代 Python 项目标准,推动 PEP 518/621 规范落地

4. 全局缓存:跨项目共享依赖缓存,节省磁盘空间并加速重复安装

5. Claude Code 集成:作为 always: true 技能,无需手动触发即可自动生效

潜在缺点与局限性

1. 生态系统成熟度uv 虽发展迅速,但部分边缘场景(如特定平台的二进制 wheel 构建)可能不如 pip 稳定
2. 学习成本:团队成员需适应新的命令语法和工作流,尤其对习惯 pip 的老开发者

3. CI/CD 兼容性:某些托管 CI 环境可能未预装 uv,需额外安装步骤(技能已提供安装脚本)

4. 锁定文件差异uv 生成的锁定机制与 pip-tools 不完全兼容,迁移项目时需验证

5. 过度依赖风险:强制优先可能导致在 uv 不支持的极端场景下产生摩擦

适合人群

  • 追求极致构建速度的 Python 开发者
  • 使用 Claude Code 进行日常编码的工程师
  • 希望统一团队工具链的技术负责人
  • 正在迁移到 pyproject.toml 现代项目结构的新项目

常规风险

  • 工具可用性:目标系统可能未安装 uv,技能虽提供回退到 pip 的机制,但自动安装脚本需要网络访问和执行权限
  • 版本锁定uv 更新频繁,命令行接口偶有变动,长期项目需关注兼容性
  • 权限问题:系统级 Python 环境使用 uv 可能涉及权限冲突,建议在虚拟环境内操作
  • 误用场景:非 Python 任务被错误触发(技能已标注 "do not use when: tasks without Python")

Prioritize uv 内容

手动下载zip · 3.1 kB
LICENSE.txttext/plain
请选择文件