规范命名

openspec/changes/archive/2026-02-04-python-runner/proposal.md

@@ -0,0 +1,43 @@
+## Why
+
+大模型在处理任务时经常需要执行Python脚本（数据分析、API测试、文件处理等），传统的做法需要在系统Python环境中预安装依赖包，这会导致：
+- 环境污染：不同任务的依赖可能冲突
+- 版本混乱：无法确保依赖版本一致性
+- 系统依赖：必须在操作系统级别安装所有可能的包
+
+使用uv的PEP 723内联元数据格式，可以让每个脚本自带依赖声明，并在隔离环境中执行，从根本上解决这些问题。
+
+## What Changes
+
+**注：** 实现时将技能名称从 `python-runner` 简化为 `python-runner`，以保持命名更通用和简洁，避免与未来可能的其他 Python runner 实现名称冲突。
+
+- 创建新的skill：`python-runner` (proposal中为 `python-runner`)
+  - 指导大模型按照PEP 723规范编写Python脚本
+- 提供临时文件创建和uv run执行的标准流程
+- 严格错误处理模式
+- 临时文件使用系统目录，系统自动清理
+
+- 技能特性：
+- 通用型工具，适用于任何Python可处理的任务
+- 无需预安装依赖，uv自动管理隔离环境
+- 使用临时文件，系统自动清理
+  - 简单返回值（stdout/stderr）
+  - 不支持命令行参数或stdin输入
+
+## Capabilities
+
+### New Capabilities
+
+- `python-runner`: 通用Python脚本执行工具，指导大模型使用uv的隔离环境特性来执行临时Python脚本，无需在系统环境预安装依赖。适用于数据处理、API交互、文件操作、科学计算等各种任务。
+
+### Modified Capabilities
+
+无
+
+## Impact
+
+- **代码影响**：新增skill文件 `skills/python-runner/SKILL.md`
+- **依赖影响**：要求系统安装uv（https://docs.astral.sh/uv/）
+- **系统影响**：无（skill只提供指导，不直接修改系统）
+- **API影响**：无
+- **用户影响**：大模型在需要执行Python脚本时，会使用此skill生成符合PEP 723规范的代码并使用uv执行，提升环境隔离和依赖管理的可靠性