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