🎯 工具简介
OpenClaw Skill 依赖分析器是一个用于分析 ClawHub 上 OpenClaw Skills 依赖关系的开源工具。它可以帮助开发者：
- 📊 自动抓取 ClawHub 上的所有 Skills 元数据
- 🔗 分析依赖关系 - 找出 Skills 之间的依赖、引用、相似度
- 🎨 生成可视化图表 - 交互式依赖关系图（D3.js 力导向图）
- 📝 生成报告 - Markdown/HTML 格式的依赖分析报告
- ⚠️ 检测问题 - 发现循环依赖、孤立 Skills、过时依赖
✨ 核心功能
🔍 自动数据抓取
支持从 ClawHub API 抓取 Skills 数据，含模拟数据支持，无需 API 即可演示
📊 依赖关系分析
构建依赖图 + 反向依赖图，检测循环依赖，找出孤立 Skills，计算依赖统计
🎨 交互式可视化
D3.js 力导向图，节点大小反映影响度，颜色区分核心/依赖多/孤立
📝 完整报告生成
Markdown + HTML 双格式，包含完整依赖列表 + 推荐建议
🔍 相似度检测
基于标签 Jaccard 相似度，发现功能相似的 Skills（阈值可调）
🚀 一键运行
提供 run_all.sh 一键运行脚本，无需手动执行多个命令
🚀 快速开始
安装
git clone https://github.com/jingchang0623-crypto/miaoquai.git
cd miaoquai/openclaw-skill-dependency-analyzer
pip install -r requirements.txt
一键运行
./run_all.sh
分步运行
# 1. 抓取数据
python3 fetch_skills.py
# 2. 分析依赖
python3 analyze_dependencies.py
# 3. 生成可视化
python3 generate_visualization.py
# 4. 生成报告
python3 generate_report.py
输出文件：
skills_data.json- 抓取的 Skills 数据dependency_graph.json- 依赖关系图数据dependency_graph.html- 交互式可视化图表dependency_report.md- Markdown 报告dependency_report.html- HTML 报告
📊 使用示例
示例输出：依赖关系图
打开 dependency_graph.html 查看交互式图表：
- 🎨 节点颜色：蓝色（普通）、绿色（被依赖多）、橙色（依赖别人多）、红色（孤立）
- 📏 节点大小：反映总影响度（依赖数 + 被依赖数）
- 🔍 Tooltip：鼠标悬停显示详细信息
- ✋ 拖拽：支持拖拽节点重新布局
- 🔎 缩放：鼠标滚轮缩放，拖拽画布平移
示例输出：分析报告
报告包含：
- 📈 概览统计（总 Skills 数、孤立 Skills、循环依赖等）
- 🔗 依赖关系统计（被依赖最多的 TOP 10、依赖最多的 TOP 10）
- ⚠️ 检测到的问题（循环依赖详情、孤立 Skills 列表）
- 🔍 相似 Skills 对（标签相似度 ≥ 0.5）
- 💡 推荐建议（新手推荐、优化建议、更新注意事项）
- 📋 完整依赖列表（所有 Skills 的依赖关系）
🔗 与妙趣AI集成
这个工具是 妙趣AI 开源工具链的一部分：
- 📚 自动生成文档 - 为 ClawHub 每个 Skill 生成详细文档页面
- 🔗 智能推荐 - 根据用户已安装的 Skills 推荐新 Skills
- ⚡ 优化安装 - 分析依赖关系，优化 Skill 安装顺序
- 🛡️ 安全检查 - 检测有安全风险的依赖组合
查看妙趣AI的 OpenClaw 玩法专题 了解更多！
📥 下载与贡献
贡献指南
欢迎贡献！请查看 CONTRIBUTING.md
开发路线图
- ✅ 基础依赖分析
- ✅ 可视化图表生成
- 🔄 实时依赖监控（计划中）
- 🔄 Skill 冲突检测（计划中）
- 🔄 自动修复建议（计划中）
- 🔄 与 OpenClaw Gateway 集成（计划中）
📞 联系我们
- 🌐 网站: miaoquai.com
- 🐙 GitHub: @jingchang0623-crypto
- 💬 飞书: 通过妙趣AI网站联系