技能依赖管理

技能简介

skill-deps 是 OpenClaw 生态的依赖管理工具，用于扫描、追踪和管理技能之间的依赖关系。支持可视化技能树结构、检测循环依赖和版本冲突，实现类似 npm 的技能包管理能力。

业务背景

技能依赖管理帮助团队理清复杂技能包之间的调用关系，避免因版本冲突或循环依赖导致系统故障。通过可视化依赖树，业务人员可快速评估技能升级的影响范围，降低运维风险。

落地案例：某团队计划升级核心数据分析技能，使用 skill-deps 扫描后发现该技能被三个下游技能引用，且存在版本锁定冲突。团队据此制定分阶段升级方案，先协调下游技能适配，再统一升级，避免了生产环境服务中断。

能做什么

• 扫描已安装技能的依赖声明
• 生成层级化的技能依赖树视图
• 检测缺失依赖和版本不兼容问题
• 识别循环依赖和技能冲突
• 从 ClawHub 仓库自动解析并安装依赖
• 支持语义化版本约束（>=、^、~、*）

使用说明

安装指令

该技能为 OpenClaw 内置工具，无需单独安装。确保 OpenClaw 环境已配置以下扫描路径：

• /usr/lib/node_modules/openclaw/skills/ — 内置技能
• ~/.openclaw/workspace/skills/ — 用户技能
• ./skills/ — 项目本地技能

基础操作

1. 扫描所有技能依赖：./scripts/scan-skills.sh
2. 查看指定技能依赖树：./scripts/skill-tree.sh [技能名]
3. 检查缺失依赖：./scripts/check-deps.sh
4. 从仓库安装技能（自动解析依赖）：./scripts/skill-install.sh [技能名]@[版本]
5. 搜索可用技能：./scripts/skill-search.sh "[关键词]"

声明依赖

在 SKILL.md 前置元数据中添加：

---
name: my-skill
depends:
  - weather@>=1.0.0      # 必需依赖
optional:
  - github@>=2.0.0        # 可选增强
conflicts:
  - old-weather           # 互斥技能
---

输入与输出

见下方输入与输出表格。

风险提示

• 版本约束语法错误会导致依赖解析失败
• 循环依赖可能引发安装死锁
• 未声明的冲突技能可能在运行时产生不可预期行为
• 自动安装会覆盖本地同名技能的不同版本

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/myrodar/skill-deps/SKILL.md
来源类型：GitHub 仓库