这是什么
research-to-diagram 是一个基于 Claude Code 的智能技能(Skill),它把「深度调研」和「知识可视化」整合到一个自动化流程中。你只需要提供一个研究主题或问题,它就会自动进行多轮网络搜索、信息提取与结构整理,然后选择合适的图表类型,生成专业的矢量 PDF 知识关系图谱,并附带所有参考来源。

这个工具特别适合处理那些需要大量资料梳理的复杂主题,比如文学作品中的人物关系、技术架构、历史事件演变、概念分类等。它由开发者 wshuyi 创建,项目采用 MIT 协议开源,目前已在 GitHub 上获得 154 个 Star 和 27 个 Fork。
适合谁
- 内容创作者与自媒体人:快速生成知识图谱,用于文章配图或视频讲解。
- 学生与研究者:辅助文献调研,梳理概念关系,节省整理时间。
- 产品经理与技术爱好者:快速理解复杂系统架构,生成架构图。
- 任何需要将复杂信息可视化的人:无需手动学习绘图工具,只需描述主题即可。
能做什么
- 自动深度调研:基于 Claude Code 内置的 WebSearch 能力,进行多轮搜索,交叉验证信息。
- 智能结构设计:根据主题自动选择最合适的图表类型(人物关系图、概念图、技术架构图等)。
- 高质量 PDF 输出:生成矢量 PDF,可无限缩放,适合打印或高清展示。
- 来源追踪:自动记录所有参考资料的链接,方便后续查证。
- 灵活定制:支持自定义布局方向、详细程度、输出位置,也可生成 PNG、SVG 等格式。
使用前准备
- 安装 Graphviz:这是生成图表的核心工具。macOS 用户使用
brew install graphviz,Linux 用户使用apt-get install graphviz。 - 安装 Claude Code:该技能依赖 Claude Code 的 WebSearch 功能,需要确保 Claude Code 环境可用。
- 网络连接:用于自动调研和资料收集。
安装方法
推荐使用 Git Clone 方式安装:
# 克隆仓库
git clone https://github.com/wshuyi/research-to-diagram.git
# 复制技能到 Claude Code 技能目录
cp -r research-to-diagram/skills/research-to-diagram ~/.claude/skills/
# 安装 Graphviz(如果尚未安装)
brew install graphviz
也可以使用插件市场方式:
# 添加插件市场
/plugin marketplace add wshuyi/research-to-diagram
# 安装技能
/plugin install research-to-diagram@wshuyi/research-to-diagram
使用示例
安装完成后,直接在 Claude Code 中用自然语言描述你的研究主题即可。例如:
深度调研《红楼梦》中的人物关系,并生成关系图谱 PDF。
输出结果包括:50+ 人物映射、7 个家族聚类、多种关系类型(血缘、婚姻、结盟)、152KB 的专业 PDF 文件,以及 7 个权威参考来源。
其他示例:
- 研究 Kubernetes 架构并生成可视化图
- 分析战国时期各国关系并创建关系图
- 快速调研 React Hooks 并生成简单概念图
也可以用这个Skill研究产品结构,比如生成WorkBuddy的产品体系:

风险与注意事项
- 信息准确性:虽然技能会从多个来源交叉验证,但自动调研结果仍可能存在偏差,重要信息建议人工复核。
- 生成时间:通常需要 2-5 分钟,复杂主题可能更久,请耐心等待。
- 依赖环境:需要 Graphviz 和 Claude Code 环境,缺少任一组件都会导致失败。
- 输出文件位置:默认保存到用户主目录,可通过指定路径调整。
- 修改能力:生成的 .dot 源文件可以手动编辑,方便进一步调整细节。