规范命名

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

@@ -0,0 +1,99 @@
+## 1. Skill结构设置
+
+ - [x] 1.1 创建skill目录：`skills/python-runner/`
+ - [x] 1.2 创建script子目录：`skills/python-runner/script/`
+ - [x] 1.3 创建辅助脚本：`skills/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/python-runner/SKILL.md`
+
+## 2. 编写YAML前置元数据
+
+ - [x] 2.1 添加skill名称：`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/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内容的清晰性和完整性