SuperAPI AI 工具集

uv-workflow

编程与开发

查看项目

更新于 10-15 20:05

技能介绍

用途:让编码智能体统一通过 uv 运行 Python 代码、模块、单行命令、工具、测试和独立脚本,并管理 PEP 723 内联元数据脚本。

主要能力与规则:不要把 python 或 python3 作为 shell 入口;执行前把直接 Python 命令转换为最接近的 uv 形式;在 uv run ... 内部使用 python 是可接受的,因为由 uv 控制解释器选择与环境准备;沙箱或缓存写入可能失败时,先设置 UV_CACHE_DIR 指向可写临时目录;独立 PEP 723 脚本由 uv 管理内联元数据,不要手工编辑元数据块。

命令映射:运行脚本用 uv run path/to/script.py;运行模块用 uv run -m package.module;运行单行命令用 uv run python -c "print('hello')";运行依赖提供的工具用 uv run tool-name;临时添加依赖用 uv run --with package python -c "...";运行测试用 uv run pytest 或 uv run -m pytest;创建独立脚本用 uv init --script path/to/script.py;添加脚本依赖用 uv add --script path/to/script.py package;移除脚本依赖用 uv remove --script path/to/script.py package。

独立脚本工作流:用 uv init --script path/to/script.py 初始化;用 uv add --script path/to/script.py <package> 添加依赖;正常编辑 Python 代码;用 uv run path/to/script.py 运行;用 uv remove --script path/to/script.py <package> 移除依赖。即使脚本概念上已存在、只需在磁盘上创建,也使用 uv init --script。

适用场景与限制:适用于 Python 执行、Python 工具、测试、单行命令和独立 PEP 723 脚本。若任务涉及带 pyproject.toml 的完整 Python 项目,应改用面向项目的 uv 命令,而非脚本专用元数据命令;仍以 uv 为入口,但不要对项目工作流强制使用 uv init --script 或 uv add --script。更多模式可阅读 references/uv-command-patterns.md,其中包含 PowerShell 与 POSIX 缓存设置、脚本生命周期示例以及项目与脚本的区分指导。