100 lines
3.8 KiB
Markdown
100 lines
3.8 KiB
Markdown
## 1. Skill结构设置
|
||
|
||
- [x] 1.1 创建skill目录：`skills/uv-python-runner/`
|
||
- [x] 1.2 创建script子目录：`skills/uv-python-runner/script/`
|
||
- [x] 1.3 创建辅助脚本：`skills/uv-python-runner/script/get_temp_path.py`
|
||
- [x] 1.3.1 添加PEP 723元数据块（`# dependencies = []`）
|
||
- [x] 1.3.2 在系统临时目录创建空的Python脚本文件并返回路径
|
||
- [x] 1.3.3 直接在stdout输出脚本文件完整路径
|
||
- [x] 1.3.4 添加命令行支持，直接运行脚本
|
||
- [x] 1.4 创建skill文件：`skills/uv-python-runner/SKILL.md`
|
||
|
||
## 2. 编写YAML前置元数据
|
||
|
||
- [x] 2.1 添加skill名称：`uv-python-runner`
|
||
- [x] 2.2 添加英文skill描述
|
||
- [x] 2.3 添加参数提示（不适用，此skill无参数）
|
||
|
||
## 3. 编写Skill内容 - 概览
|
||
|
||
- [x] 3.1 编写skill目的和定位
|
||
- [x] 3.2 说明为什么uv是有益的（环境隔离、依赖管理）
|
||
- [x] 3.3 列出何时使用此skill
|
||
|
||
## 4. 编写Skill内容 - 何时使用章节
|
||
|
||
- [x] 4.1 记录典型用例（数据处理、API交互、文件操作等）
|
||
- [x] 4.2 记录此skill不适用的场景（交互式输入、持久化环境等）
|
||
|
||
## 5. 编写Skill内容 - 工作流程章节
|
||
|
||
- [x] 5.1 记录步骤1：生成符合PEP 723的Python脚本
|
||
- [x] 5.1.1 说明元数据块格式
|
||
- [x] 5.1.2 提供包含外部依赖的示例
|
||
- [x] 5.1.3 提供仅使用标准库的示例
|
||
- [x] 5.2 记录步骤2：获取临时目录
|
||
- [x] 5.2.1 说明调用辅助脚本：`uv run skills/uv-python-runner/script/get_temp_path.py`
|
||
- [x] 5.2.2 说明辅助脚本直接在stdout输出临时目录路径
|
||
- [x] 5.2.3 说明大模型捕获stdout输出得到临时目录
|
||
- [x] 5.2.4 说明根据临时目录构造脚本文件路径：`<temp_dir>/uv_script_<timestamp>_<random>.py`
|
||
- [x] 5.2.5 提供简化的工作流示例
|
||
- [x] 5.3 记录步骤3：使用uv执行
|
||
- [x] 5.3.1 说明`uv run`命令的用法
|
||
- [x] 5.3.2 描述uv自动做什么（隔离、依赖安装）
|
||
|
||
## 6. 编写Skill内容 - 错误处理章节
|
||
|
||
- [x] 6.1 记录uv未安装场景
|
||
- [x] 6.1.1 提供清晰错误消息
|
||
- [x] 6.1.2 包含uv安装链接
|
||
- [x] 6.2 记录Python语法错误场景
|
||
- [x] 6.2.1 说明文件创建前的检测
|
||
- [x] 6.2.2 提供错误消息格式
|
||
- [x] 6.3 记录依赖解析失败场景
|
||
- [x] 6.3.1 说明显示uv错误输出
|
||
- [x] 6.3.2 说明文件保留
|
||
- [x] 6.4 记录脚本运行时错误场景
|
||
- [x] 6.4.1 说明显示完整traceback
|
||
- [x] 6.4.2 说明文件保留和路径显示
|
||
|
||
## 7. 编写Skill内容 - 示例章节
|
||
|
||
- [x] 7.1 提供示例1：数据分析（pandas）
|
||
- [x] 7.1.1 显示完整的PEP 723脚本
|
||
- [x] 7.1.2 说明场景
|
||
- [x] 7.2 提供示例2：API交互（requests）
|
||
- [x] 7.2.1 显示完整的PEP 723脚本
|
||
- [x] 7.2.2 说明场景
|
||
- [x] 7.3 提供示例3：文件操作（标准库）
|
||
- [x] 7.3.1 显示完整的PEP 723脚本
|
||
- [x] 7.3.2 说明场景
|
||
|
||
## 8. 编写Skill内容 - 注意事项章节
|
||
|
||
- [x] 8.1 创建"为什么使用uv？"对比表
|
||
- [x] 8.2 记录最佳实践
|
||
- [x] 8.2.1 总是使用内联元数据
|
||
- [x] 8.2.2 使用最新版本
|
||
- [x] 8.2.3 错误处理指南
|
||
- [x] 8.3 记录限制
|
||
- [x] 8.3.1 无命令行参数
|
||
- [x] 8.3.2 无stdin输入
|
||
- [x] 8.3.3 无持久化环境
|
||
- [x] 8.3.4 无自定义Python版本
|
||
- [x] 8.3.5 无复杂依赖约束
|
||
|
||
## 9. 编写Skill内容 - 依赖章节
|
||
|
||
- [x] 9.1 列出必需依赖：uv
|
||
- [x] 9.2 包含uv文档链接
|
||
- [x] 9.3 标记可选依赖（此skill无）
|
||
|
||
## 10. 验证和测试
|
||
|
||
- [x] 10.1 验证YAML前置元数据格式有效
|
||
- [x] 10.2 检查所有Markdown章节格式正确
|
||
- [x] 10.3 确保所有示例在语法上是正确的Python
|
||
- [x] 10.4 验证所有PEP 723元数据块符合规范
|
||
- [x] 10.5 确认所有链接（uv安装）正确
|
||
- [x] 10.6 审查skill内容的清晰性和完整性
|