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