用途
Python Scripting 技能用于创建自包含的 Python 脚本,基于 uv 和 PEP 723 内联脚本元数据(inline script metadata)实现依赖的自动管理。它面向需要独立运行、无需预先配置虚拟环境或手动安装依赖的脚本场景。
主要能力
- 创建独立的 Python 脚本
- 使用 PEP 723 内联依赖声明
- 设置参数解析
- 处理输入与输出
- 配置可复现的构建
使用方式
脚本采用 PEP 723 格式声明元数据,示例格式如下:
#!/usr/bin/env -S uv run --script
# /// script
# requires-python = ">=3.12"
# dependencies = [
# "requests",
# "rich",
# ]
# ///
运行脚本:
uv run script.py [args]
依赖会在首次运行时自动安装。
技能包含参考文件:references/UV_SCRIPT.template.py,即带有 PEP 723 元数据的 Python 脚本模板。
适用场景
- 独立实用脚本
- 一次性自动化任务
- 快速数据处理
- CLI 工具
- 需要依赖的脚本
最佳实践
- 使用 exclude-newer 以保证可复现性
- 在 docstring 中包含用法示例
- 使用 argparse 处理 CLI 参数
- 返回退出码(0 表示成功,非零表示错误)
- 保持脚本聚焦于单一任务
限制
资料未提供关于平台兼容性、uv 版本要求、性能表现或收费情况的具体说明,暂未提供。