## 1. 文档准备 - [x] 1.1 备份现有 SKILL.md 文件为 SKILL.md.backup - [x] 1.2 阅读 lyxy-runner-python 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 确认无需新增辅助脚本(项目检测直接使用命令行工具)