66 lines
2.2 KiB
Markdown
66 lines
2.2 KiB
Markdown
---
|
||
name: lyxy-runner-python
|
||
description: Any task that requires Python processing should use this skill.
|
||
---
|
||
|
||
# UV Python Runner Skill
|
||
|
||
指导大模型使用uv运行Python脚本，无需预安装依赖，保持环境整洁。
|
||
|
||
## Purpose
|
||
|
||
**必需依赖**: 此skill必需uv工具，不兼容其他Python运行方式。
|
||
|
||
利用uv隔离环境特性：
|
||
- 自动管理虚拟环境和依赖
|
||
- 避免系统Python污染
|
||
- 支持用户现有脚本（无需修改）
|
||
- 自动解析依赖并使用`--with`传递
|
||
- 智能检测uv项目，复用项目环境
|
||
- 跨平台兼容（Windows/macOS/Linux）
|
||
|
||
**重要**: 如果uv未安装，立即停止任务并引导用户安装。不要使用python、pip、poetry、venv等替代工具。
|
||
|
||
## When to Use
|
||
|
||
任何Python处理任务都应使用此skill。
|
||
|
||
### 典型场景
|
||
- **数据处理**: pandas, numpy, scipy / CSV/JSON/YAML转换 / 统计分析
|
||
- **API交互**: HTTP请求（requests, httpx） / API数据检索
|
||
- **文件操作**: 重命名、批量处理 / pathlib, shutil操作
|
||
- **科学计算**: numpy, scipy / matplotlib, plotly可视化
|
||
- **系统工具**: logging / configparser / tqdm, rich进度跟踪
|
||
|
||
### 不适用场景
|
||
- ✗ 需要用户交互（input()）
|
||
- ✗ 需要持久化环境（每次都是新环境）
|
||
- ✗ 需要命令行参数
|
||
- ✗ 需要从stdin读取
|
||
|
||
## Quick Reference
|
||
|
||
| 场景 | 命令 |
|
||
|------|------|
|
||
| uv项目 | `uv run <script_path>` |
|
||
| 非uv+有依赖 | `uv run --with pkg1 --with pkg2 <script_path>` |
|
||
| 非uv+无依赖 | `uv run <script_path>` |
|
||
|
||
## Workflow
|
||
|
||
1. **解析依赖**：分析import语句，提取外部包名（排除标准库）
|
||
2. **检测项目**：执行`uv sync --dry-run`判断是否为uv项目
|
||
3. **确定路径**：用户指定路径 → 现有脚本 → 临时文件
|
||
4. **构造命令**：根据项目类型和依赖构造执行命令
|
||
5. **执行脚本**：运行并捕获输出
|
||
|
||
## References
|
||
|
||
详细文档请参阅 `references/` 目录：
|
||
|
||
| 文件 | 内容 |
|
||
|------|------|
|
||
| `references/examples.md` | 数据分析、API交互、文件操作等完整示例 |
|
||
| `references/error-handling.md` | uv未安装、依赖解析失败等错误处理指南 |
|
||
| `references/best-practices.md` | 依赖解析、路径处理、项目检测等最佳实践 |
|