94 lines
4.3 KiB
Markdown
94 lines
4.3 KiB
Markdown
## 1. 文档准备
|
||
|
||
- [x] 1.1 备份现有 SKILL.md 文件为 SKILL.md.backup
|
||
- [x] 1.2 阅读 python-runner skill 文档结构，了解现有内容组织方式
|
||
|
||
## 2. 移除PEP 723相关内容
|
||
|
||
- [x] 2.1 移除"生成符合PEP 723规范的Python脚本"相关章节
|
||
- [x] 2.2 移除所有PEP 723元数据块的示例代码
|
||
- [x] 2.3 移除`# /// script`、`# dependencies = []`等PEP 723语法说明
|
||
- [x] 2.4 更新Purpose部分，移除对PEP 723的提及
|
||
|
||
## 3. 添加依赖解析指导
|
||
|
||
- [x] 3.1 添加"自动解析脚本依赖"章节，说明如何从import语句提取依赖
|
||
- [x] 3.2 添加常见Python标准库模块列表（os、sys、json、pathlib等）
|
||
- [x] 3.3 添加依赖解析示例（pandas、numpy、requests等外部包）
|
||
- [x] 3.4 说明去重逻辑和过滤标准库的规则
|
||
|
||
## 4. 添加项目检测流程
|
||
|
||
- [x] 4.1 添加"智能项目检测"章节，说明使用`uv sync --dry-run`检测uv项目
|
||
- [x] 4.2 说明检测逻辑：exit code 0为uv项目，非零为非uv项目
|
||
- [x] 4.3 添加项目检测失败的处理说明（回退到非uv项目模式）
|
||
|
||
## 5. 更新路径处理说明
|
||
|
||
- [x] 5.1 添加路径处理三层逻辑说明（用户指定 → 现有脚本 → 临时文件）
|
||
- [x] 5.2 更新临时文件获取流程，保留`get_temp_path.py`辅助脚本的使用
|
||
- [x] 5.3 添加用户指定路径的处理说明和示例
|
||
- [x] 5.4 添加现有脚本直接执行的说明
|
||
|
||
## 6. 更新执行命令示例
|
||
|
||
- [x] 6.1 添加uv项目内执行命令示例：`uv run script.py`
|
||
- [x] 6.2 添加非uv项目有依赖执行命令示例：`uv run --with pandas --with numpy script.py`
|
||
- [x] 6.3 添加非uv项目无依赖执行命令示例：`uv run script.py`
|
||
- [x] 6.4 移除所有使用PEP 723元数据的执行示例
|
||
|
||
## 7. 更新工作流章节
|
||
|
||
- [x] 7.1 重写工作流步骤，移除"步骤1：生成符合PEP 723的Python脚本"
|
||
- [x] 7.2 新增"步骤1：解析脚本依赖"（读取或生成脚本后分析import语句）
|
||
- [x] 7.3 新增"步骤2：检测是否为uv项目"（执行`uv sync --dry-run`）
|
||
- [x] 7.4 更新"步骤3：根据用户需求确定脚本路径"
|
||
- [x] 7.5 更新"步骤4：根据检测结果构造执行命令"
|
||
- [x] 7.6 更新完整工作流示例，包含三种场景（uv项目、非uv项目有依赖、非uv项目无依赖）
|
||
|
||
## 8. 更新错误处理章节
|
||
|
||
- [x] 8.1 添加项目检测失败的场景和错误处理
|
||
- [x] 8.2 添加依赖解析不准确导致执行失败的处理说明
|
||
- [x] 8.3 更新现有错误处理场景，移除对PEP 723的引用
|
||
- [x] 8.4 添加路径权限问题的错误处理
|
||
|
||
## 9. 更新示例章节
|
||
|
||
- [x] 9.1 重写"示例1：数据分析"，使用标准Python脚本（无PEP 723）
|
||
- [x] 9.2 重写"示例2：API交互"，使用标准Python脚本（无PEP 723）
|
||
- [x] 9.3 重写"示例3：文件操作"，使用标准Python脚本（无PEP 723）
|
||
- [x] 9.4 新增"示例4：uv项目内执行"，展示在uv项目中的执行流程
|
||
- [x] 9.5 新增"示例5：用户指定路径"，展示指定存储路径的执行流程
|
||
|
||
## 10. 更新说明和最佳实践
|
||
|
||
- [x] 10.1 更新"为什么使用uv？"表格，移除PEP 723相关说明
|
||
- [x] 10.2 更新"最佳实践"部分，移除PEP 723相关内容
|
||
- [x] 10.3 添加新的最佳实践：依赖解析的准确性注意事项
|
||
- [x] 10.4 更新"限制"部分，移除PEP 723相关限制
|
||
- [x] 10.5 添加新的限制说明：项目检测失败、动态导入等
|
||
|
||
## 11. 更新Workflow Summary
|
||
|
||
- [x] 11.1 重写完整工作流示例，反映新的执行流程
|
||
- [x] 11.2 更新关键特点说明，移除PEP 723相关内容
|
||
- [x] 11.3 添加项目检测和依赖解析的特点说明
|
||
|
||
## 12. 验证和测试
|
||
|
||
- [x] 12.1 在Windows平台测试uv项目检测
|
||
- [x] 12.2 在macOS平台测试uv项目检测
|
||
- [x] 12.3 在Linux平台测试uv项目检测
|
||
- [x] 12.4 测试依赖解析准确性（包含标准库和外部包）
|
||
- [x] 12.5 测试三种路径模式（用户指定、现有脚本、临时文件）
|
||
- [x] 12.6 测试错误处理场景（uv未安装、语法错误、依赖失败等）
|
||
- [x] 12.7 验证SKILL.md文档的完整性和一致性
|
||
|
||
## 13. 清理和提交
|
||
|
||
- [x] 13.1 删除备份文件 SKILL.md.backup（如果一切正常）
|
||
- [x] 13.2 验证修改后的SKILL.md符合所有spec要求
|
||
- [x] 13.3 确认辅助脚本 `get_temp_path.py` 仍然可用
|
||
- [x] 13.4 确认无需新增辅助脚本（项目检测直接使用命令行工具）
|