1
0
Files
Skill/openspec/changes/archive/2026-02-04-uv-python-runner/proposal.md

1.7 KiB
Raw Blame History

Why

大模型在处理任务时经常需要执行Python脚本数据分析、API测试、文件处理等传统的做法需要在系统Python环境中预安装依赖包这会导致

  • 环境污染:不同任务的依赖可能冲突
  • 版本混乱:无法确保依赖版本一致性
  • 系统依赖:必须在操作系统级别安装所有可能的包

使用uv的PEP 723内联元数据格式可以让每个脚本自带依赖声明并在隔离环境中执行从根本上解决这些问题。

What Changes

  • 创建新的skilluv-python-runner

    • 指导大模型按照PEP 723规范编写Python脚本
  • 提供临时文件创建和uv run执行的标准流程

  • 严格错误处理模式

  • 临时文件使用系统目录,系统自动清理

  • 技能特性:

  • 通用型工具适用于任何Python可处理的任务

  • 无需预安装依赖uv自动管理隔离环境

  • 使用临时文件,系统自动清理

    • 简单返回值stdout/stderr
    • 不支持命令行参数或stdin输入

Capabilities

New Capabilities

  • uv-python-runner: 通用Python脚本执行工具指导大模型使用uv的隔离环境特性来执行临时Python脚本无需在系统环境预安装依赖。适用于数据处理、API交互、文件操作、科学计算等各种任务。

Modified Capabilities

Impact

  • 代码影响新增skill文件 skills/uv-python-runner/SKILL.md
  • 依赖影响要求系统安装uvhttps://docs.astral.sh/uv/
  • 系统影响skill只提供指导不直接修改系统
  • API影响:无
  • 用户影响大模型在需要执行Python脚本时会使用此skill生成符合PEP 723规范的代码并使用uv执行提升环境隔离和依赖管理的可靠性