name: python-scripting description: 使用 uv 和 PEP 723 内联依赖进行 Python 脚本编写。适用于创建具有自动依赖管理的独立 Python 脚本。 author: Joseph OBrien status: unpublished updated: ‘2025-12-23’ version: 1.0.1 tag: skill type: skill
Python 脚本编写技能
使用 uv 和 PEP 723 内联脚本元数据创建自包含的 Python 脚本。
此技能的功能
- 创建独立的 Python 脚本
- 使用 PEP 723 内联依赖声明
- 设置参数解析
- 处理输入/输出
- 配置可复现的构建环境
使用场景
- 独立的实用工具脚本
- 一次性自动化任务
- 快速数据处理
- 命令行工具
- 需要依赖项的脚本
参考文件
references/UV_SCRIPT.template.py- 包含 PEP 723 元数据的 Python 脚本模板
PEP 723 格式
#!/usr/bin/env -S uv run --script
# /// script
# requires-python = ">=3.12"
# dependencies = [
# "requests",
# "rich",
# ]
# ///
运行脚本
uv run script.py [参数]
依赖项在首次运行时自动安装。
最佳实践
- 使用
exclude-newer确保可复现性 - 包含带有使用示例的文档字符串
- 使用 argparse 处理命令行参数
- 返回退出码（0 表示成功，非零表示错误）
- 保持脚本专注于单一任务