自动检测并解决多个技能 requirements.txt 文件中冲突的 Python 包版本,生成合并后无冲突的需求文件。
Skill Dependency Resolver
功能概述
Skill Dependency Resolver是一项面向实际任务的技能,主要用于自动检测并解决技能间的 Python 依赖冲突;当安装多个 OpenClaw 技能时,不同技能可能依赖不同版本的 Python 包(如 pandas、numpy),导致冲突和安装失败;
核心要点
- 本技能自动扫描所有技能的 requirements.txt ,检测版本冲突,并提供自动解决策略,生成统一的 requirements-merged.。
- 它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。
- 从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。
使用与执行
实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;
结果检查与注意事项
涉及批量任务时,还应保存进度,避免中断后重复操作。该技能适合用于一次性任务,也可以接入自动化工作流,与其他技能或上层代理配合完成更完整的业务链路;在组合使用时,应明确每一步的输入输出关系,并避免不同步骤之间出现参数冲突。
Skill Dependency Resolver
自动检测并解决技能间的 Python 依赖冲突
描述
当安装多个 OpenClaw 技能时,不同技能可能依赖不同版本的 Python 包(如 pandas、numpy),导致冲突和安装失败。本技能自动扫描所有技能的 requirements.txt,检测版本冲突,并提供自动解决策略,生成统一的 requirements-merged.txt 供一键安装。
使用场景
- 用户安装多个技能后出现
pip install版本冲突错误 - 技能开发者希望确保自己的技能与其他技能兼容
- 系统管理员需要批量部署技能到多台机器
- 希望自动化依赖管理,减少手动调试时间
功能清单
- ✅ 扫描指定技能目录下的所有
requirements.txt - ✅ 解析包名和版本规范(>=, <=, ~=, ==, !=)
- ✅ 检测同一包的不同版本要求
- ✅ 提供自动解决策略(选择最高版本或最低版本)
- ✅ 支持手动模式,列出冲突供用户选择
- ✅ 生成合并后的
requirements.txt - ✅ 输出简洁的分析报告(JSON 格式)
- ✅ 零外部依赖,纯 Python 标准库实现
输入参数
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
skills_dir |
string | 否 | ~/.openclaw/workspace/skills |
技能目录路径,递归搜索所有子目录的 requirements.txt |
output_file |
string | 否 | ./requirements-merged.txt |
输出的合并后 requirements 文件路径 |
strategy |
string | 否 | auto |
冲突解决策略:auto(自动选最高版本),manual(列出冲突等待用户选择) |
输出
report(object): 依赖分析报告total_skills(int): 扫描的技能数量conflicts_count(int): 检测到的冲突数量solutions(array): 每个冲突的解决方案(包名、冲突版本、选定版本、策略)output_path(string): 生成的 merged requirements 文件路径summary(string): 简要总结
示例
基本扫描(自动解决)
skill-dependency-resolver skills_dir="./skills" output_file="requirements.txt"
手动模式(列出冲突供选择)
skill-dependency-resolver strategy="manual"
扫描并生成报告
skill-dependency-resolver output_file="/tmp/merged.txt" | jq '.conflicts_count'
技术细节
- 扫描机制:使用
os.walk递归查找requirements.txt,跳过tests/和node_modules/ - 解析器:使用正则表达式解析包名和版本规范,支持
pkg>=1.0,<=2.0格式 - 冲突检测:收集每个包的所有版本范围,检查是否存在不可交集的区间
- 解决算法:
auto:取所有版本上限中的最小值(保守)或下限中的最大值(激进,当前使用:选最高版本)manual:输出冲突详情供用户决策
- 输出生成:将选定版本写入新 requirements 文件,保留原始注释(如有)
限制
- 仅支持 Python
requirements.txt格式,不支持Pipfile或pyproject.toml - 版本规范解析基于正则,可能无法覆盖所有复杂情况(如环境标记
; python_version < "3.8") - 不执行实际的
pip install,仅生成合并后的文件
未来增强
- 支持
pyproject.toml和Pipfile - 检测并建议虚拟环境(避免全局冲突)
- 集成到
clawhub install流程,自动预处理依赖 - 提供冲突解决的历史记录和回滚
相关技能
skill-composer:工作流编排,可调用本技能预处理依赖skill-secure-checker:安全扫描,确保合并后的 requirements 无恶意包workspace-heartbeat-integration:定期扫描依赖,保持系统健康
作者:小叮当
标签:devops, dependency, installation, quality
许可证:MIT
热门AI工具
相关专题
用 Tailwind CSS 制作导航栏和卡片,可先搭建语义化结构,再组合 Flex、Grid、间距、圆角与阴影类。这里整理横向导航、移动端菜单、卡片网格及悬停效果的相关文章,帮助你把常见页面组件做得清晰且适配不同屏幕。
0
2026.11.03
Tailwind CSS 响应式布局通常从移动端样式写起,再用 sm、md、lg 等前缀调整不同屏幕宽度下的网格、间距和导航。本专题整理断点配置、Grid 与 Flex 自适应布局及常见溢出问题,帮助你逐步完成多设备适配。
0
2026.11.03
Tailwind CSS 类名很多,先按布局、间距、文字、颜色和状态分组记忆,再通过官方文档检索具体写法。本专题结合类名排序、动态拼接失效、自定义实用类等问题,帮助你建立常用类名的速查方法。
0
2026.11.03
本专题汇总了码上飞(CodeFlying)的官方入口地址合集,涵盖官网主站及网页版在线使用入口,支持注册登录后直接在线体验零代码AI应用生成。同时整理了APP端下载渠道与小程序入口,助你快速访问平台,通过自然语言描述需求即可生成应用、小程序或网站。
0
2026.11.03
本专题汇总了Uvicorn服务器常见问题与报错解决的教程合集,涵盖启动失败、端口占用、模块导入错误、事件循环冲突及热重载失效等典型故障的排查思路。同时整理了多进程与Worker配置、SSL/HTTPS证书报错、跨域与代理配置等实战解决方案,助你快速定位并解决Uvicorn运行中的各类问题。
0
2026.11.02
本专题汇总了Uvicorn使用教程与启动运行指南,涵盖其作为Python ASGI服务器的定位与特点,以及命令行启动(uvicorn main:app --reload)、参数配置(host/port/workers)、程序内嵌运行与Gunicorn结合部署等核心用法。同时整理了热重载调试、日志配置与生产环境部署优化等技巧,助你快速掌握Uvicorn的运行与配置。
0
2026.11.02
本专题汇总了Uvicorn的安装配置教程与部署指南,涵盖通过pip安装Uvicorn、启动FastAPI/Starlette应用、开发模式热重载(--reload)及多进程工作模式配置等核心操作。同时整理了结合Gunicorn的生产部署方案、HTTPS与反向代理配置及性能调优技巧,助你快速完成Uvicorn服务的安装与上线部署。
0
2026.11.02
Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章,帮助读者完成上线流程。
0
2026.10.28
Vite搭配Vue.js专题汇集创建Vue 3项目、配置开发环境、路径别名、Vue插件、代理、多环境构建与调试的已审核文章,帮助读者完成从初始化到日常开发的配置。
0
2026.10.28
热门下载
相关下载
精品课程
共6课时 | 12.1万人学习
共79课时 | 161.7万人学习
共6课时 | 54.7万人学习
最新文章