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

42 lines
1.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
## Why
大模型在处理任务时经常需要执行Python脚本数据分析、API测试、文件处理等传统的做法需要在系统Python环境中预安装依赖包这会导致
- 环境污染:不同任务的依赖可能冲突
- 版本混乱:无法确保依赖版本一致性
- 系统依赖:必须在操作系统级别安装所有可能的包
使用uv的PEP 723内联元数据格式可以让每个脚本自带依赖声明并在隔离环境中执行从根本上解决这些问题。
## What Changes
- 创建新的skill`uv-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执行提升环境隔离和依赖管理的可靠性