关于 uv
用于指导 Python 项目开发的 uv 策略技能,面向遵循统一工程规范的开发流程。它规定依赖管理、脚本运行和 TOML 文件读写方式,并指向 uv 文档等外部资料。
主要功能
- 01统一 Python 架构、类型与测试规范
- 02使用 uv add、uv sync 和 uv run
- 03规定 PEP 723 脚本 shebang
- 04要求 tomlkit 使用文本模式
- 05提供 uv 文档与迁移指南入口
适用场景
- 01为 Python 项目添加或同步依赖
- 02通过 uv 运行 Python 代码和脚本
- 03使用 tomlkit 读写 TOML 配置
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ jamie-bitflight/ claude_skills --skill uv安装后在 Claude Code 中输入/uv确认已加载。
详细介绍
uv — 策略
优先级:本策略(下文)> astral:uv(如果已安装)/ 实时 docs.astral.sh,用于命令
语法、迁移表和常规用法(此处未重复)。
策略
- 对于通用架构、类型标注、测试和 CLI 规则,遵循
python-engineering:standards-for-python-development。 - 所有 Python 工作均使用
uv add/uv sync/uv run——绝不使用uv pip install、uv venv或source .venv/bin/activate。使用uv.lock管理的项目和 PEP 723 脚本无需使用 Astral 文档中介绍的兼容 pip 的方式。 - 可移植的 PEP 723 脚本 shebang:
#!/usr/bin/env -S uv run --quiet --script。除非脚本有意与调用方已激活的虚拟环境耦合,否则省略--active。 - 使用文本模式(
'r'/'w')处理tomlkit,绝不使用二进制模式('rb'/'wb')——二进制模式会返回bytes,而tomlkit无法解析或写入bytes。
外部资源(如果未安装 astral:uv)
评论
支持 Markdown