1
0

统一skill命名

This commit is contained in:
2026-02-12 17:57:05 +08:00
parent 53707efaf0
commit 86308675ea
40 changed files with 191 additions and 193 deletions

View File

@@ -0,0 +1,93 @@
## 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 重写"示例2API交互"使用标准Python脚本无PEP 723
- [x] 9.3 重写"示例3文件操作"使用标准Python脚本无PEP 723
- [x] 9.4 新增"示例4uv项目内执行"展示在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 确认无需新增辅助脚本(项目检测直接使用命令行工具)