🎯 工具简介
OpenClaw Skill Graph Visualizer 是一个强大的依赖关系可视化工具,帮助开发者理解和优化他们的 OpenClaw Skill 架构。
通过解析 SKILL.md 文件,自动提取工具引用、文件依赖、显式声明,生成交互式 D3.js 力导向图和详细分析报告。
✨ 功能特性
🔍 自动扫描
解析 SKILL.md 文件,提取所有元数据(描述、工具、依赖)
🕸️ 交互式依赖图
基于 D3.js 的力导向图,支持拖拽、缩放、悬停详情
🔄 循环依赖检测
自动发现并报告循环依赖,避免架构问题
📊 统计报告
生成详细的 Markdown 报告,包含架构建议
🎯 精准解析
提取工具引用、文件依赖、显式声明
🚀 零依赖
只需 Python 3.8+ 和现代浏览器,D3.js 通过 CDN 加载
🚀 快速开始
# 1. 克隆仓库
git clone https://github.com/jingchang0623-crypto/openclaw-skill-graph-visualizer.git
cd openclaw-skill-graph-visualizer
# 2. 直接使用
python3 skill_graph_visualizer.py --skills-dir ~/.openclaw/skills --output ./output
# 3. 打开可视化
open output/skill-dependency-graph.html
⭐ GitHub 仓库
📖 在线文档
git clone https://github.com/jingchang0623-crypto/openclaw-skill-graph-visualizer.git
cd openclaw-skill-graph-visualizer
# 2. 直接使用
python3 skill_graph_visualizer.py --skills-dir ~/.openclaw/skills --output ./output
# 3. 打开可视化
open output/skill-dependency-graph.html
📋 使用示例
基本用法
# 分析默认 Skills 目录
python3 skill_graph_visualizer.py
# 指定自定义目录
python3 skill_graph_visualizer.py --skills-dir ./my-skills
# 指定输出目录
python3 skill_graph_visualizer.py --output ./reports
python3 skill_graph_visualizer.py
# 指定自定义目录
python3 skill_graph_visualizer.py --skills-dir ./my-skills
# 指定输出目录
python3 skill_graph_visualizer.py --output ./reports
输出文件
output/
├── skill-dependency-graph.html # 交互式 D3.js 可视化
└── dependency-report.md # 详细分析报告
├── skill-dependency-graph.html # 交互式 D3.js 可视化
└── dependency-report.md # 详细分析报告
🎯 适用场景
- Skill 开发者 - 了解你的 Skill 依赖哪些其他 Skill
- 架构师 - 发现并消除循环依赖
- 社区管理者 - 生成社区 Skills 全景图
- 新手入门 - 快速了解 OpenClaw 生态中的热门 Skills
🧠 技术原理
- 扫描 SKILL.md - 遍历目录,解析每个 Skill 的元信息
- 提取依赖 - 分析代码块中的工具引用、文件链接、Dependencies 章节
- 构建图结构 - 使用 NetworkX 风格的依赖图
- 检测循环 - DFS 算法检测循环依赖
- 可视化输出 - D3.js 力导向图 + 统计 HTML
🚀 关于妙趣AI
妙趣AI (miaoquai.com) 是专业的 OpenClaw 生态合作伙伴,提供:
- 📚 OpenClaw 中文教程 - 从入门到精通
- 🛠️ 开源工具开发 - 提升开发效率
- 🔍 SEO 优化服务 - 让更多人发现你的 Skill
- 🤝 社区运营支持 - 连接开发者与用户