Diagram Design与Claude Code集成:AI辅助图表生成工作流
Diagram Design与Claude Code集成:AI辅助图表生成工作流
GitHub 加速计划 / di / diagram-design是一个为Claude Code打造的图表设计工具,提供13种编辑图表类型,采用独立的HTML+SVG格式,无阴影设计,避免了Mermaid的杂乱风格,帮助用户快速创建专业级图表。
为什么选择Diagram Design与Claude Code集成?
在日常写作和项目开发中,我们经常需要创建各种图表来可视化复杂的概念和流程。传统的图表制作工具要么操作复杂,要么生成的图表风格与项目品牌不符,导致效率低下。Diagram Design与Claude Code的集成解决了这些痛点,让AI辅助图表生成变得简单高效。
核心优势
-
丰富的图表类型:提供14种不同类型的图表,包括架构图、流程图、序列图、状态机图等,满足各种场景需求。
-
品牌风格统一:只需60秒,该技能就能读取你的网站,将颜色和字体映射到每个图表,使图表与你的品牌风格保持一致,无需长时间的颜色选择和调整。
-
简单易用:无需Figma等复杂设计工具,也无需编写大量代码,通过与Claude Code交互,即可快速生成高质量图表。
集成步骤:快速开始使用AI辅助图表生成
安装Diagram Design
要将Diagram Design与Claude Code集成,首先需要安装该工具。你可以通过以下两种方式进行安装:
方法一:克隆仓库并创建符号链接
# 克隆仓库到本地
git clone https://gitcode.com/gh_mirrors/di/diagram-design ~/code/diagram-design
# 创建符号链接到Claude Code的技能目录
ln -s ~/code/diagram-design/skills/diagram-design ~/.claude/skills/diagram-design
方法二:作为插件安装
如果你只是想尝试一下,可以选择作为插件安装,但这种方式下对references/style-guide.md的编辑在插件更新后不会保留。
Claude Code:
/plugin marketplace add cathrynlavery/diagram-design
/plugin install diagram-design@diagram-design
Claude Cowork: 自定义 → 目录 → 插件 → + → 粘贴 cathrynlavery/diagram-design → 同步,然后从个人列表中安装。
Codex:
npx skills add https://github.com/cathrynlavery/diagram-design --skill diagram-design
安装完成后,重启Claude Code,该技能将注册为diagram-design,并在你要求Claude制作图表时激活。
品牌风格定制
Diagram Design的一大特色是能够根据你的网站自动提取品牌风格,包括颜色和字体,使生成的图表与你的品牌保持一致。
自动提取流程
- 在Claude Code中输入:
"onboard diagram-design to https://yoursite.com" - Claude会获取你的网站首页,提取主导调色板和字体栈。
- 将检测到的值映射到语义角色:纸张色、墨水色、-muted色、强调色、链接色等。
- 显示建议的差异,并将你的令牌写入
references/style-guide.md。 - 你确认后,输入:
"yes, apply it",即可完成品牌风格的定制。
从网站提取的内容将对应图表中的各种元素,例如网站的<body>背景色将成为图表的paper令牌,主要文本颜色成为ink令牌等。
手动覆盖
如果你希望手动设置令牌,可以打开skills/diagram-design/references/style-guide.md进行编辑。所有下游内容,包括14种图表、注释原语和图库,都将继承语义角色名称(如accent,而不是#eb6c36)。
AI辅助图表生成工作流详解
快速创建图表
安装并定制好品牌风格后,你可以通过与Claude Code交互快速创建图表。例如:
# 在Claude Code中直接询问:
# "Make me an architecture diagram of my app: frontend, backend, database, Redis cache."
# "I need a quadrant showing Q2 projects by impact vs effort."
# "Give me a sequence diagram of the OAuth handshake."
Claude会选择合适的图表类型,构建HTML并保存。你也可以直接从模板开始创建:
cp assets/template.html my-diagram.html # 最小化浅色模板
cp assets/template-full.html my-diagram.html # 带摘要卡片的编辑模板
图表类型展示
Diagram Design提供了14种不同类型的图表,以下是部分示例:
流程图:用于展示决策逻辑和流程步骤,帮助理解复杂的业务流程。
ER图/数据模型:展示实体和字段之间的关系,是数据库设计的重要工具。
你可以打开skills/diagram-design/assets/index.html在浏览器中浏览所有14种图表,并通过标签页切换浅色、深色和全编辑模式。
工作流架构
Diagram Design采用渐进式披露架构,SKILL.md是一个精简的索引,告诉Claude如何选择类型和查找细节。每种类型都位于自己的参考文件中,仅在相关时加载,保持Claude的工作上下文紧凑,同时使技能易于扩展。
例如,当你要求制作流程图时,Claude会加载SKILL.md和references/type-flowchart.md;进行技能入职时,会加载SKILL.md、references/onboarding.md和references/style-guide.md。
设计系统与最佳实践
设计系统概述
Diagram Design的设计系统遵循以下原则:一种强调色,每个图表1-2个焦点元素;三种字体族:Instrument Serif(标题和斜体标注)、Geist sans(节点名称)、Geist Mono(技术子标签);1px细线边框,无阴影,最大边框半径10px;每个坐标、宽度和间隙都能被4整除,确保图表不会有AI生成的感觉。
何时不使用此技能
虽然Diagram Design功能强大,但在某些情况下可能不适用:
- 用于推文或终端输出的快速unicode图表,应使用wiretext风格的技能。
- 任何列表,应使用表格或项目符号。
- 前后对比,应使用表格。
- 单一形状的“图表”,如带标签的单个框,直接写句子即可。
在绘制图表之前,问自己:读者从图表中学到的东西是否比从一篇写得好的段落中更多?如果不是,就不要绘制。
总结
Diagram Design与Claude Code的集成,为用户提供了一种简单、高效的AI辅助图表生成工作流。通过丰富的图表类型、品牌风格自动定制和简单的交互方式,帮助用户快速创建专业、美观且与品牌风格一致的图表。无论是项目文档、技术博客还是业务演示,Diagram Design都能成为你得力的图表制作工具。
现在就尝试安装Diagram Design,体验AI辅助图表生成的便捷与高效吧!更多详细信息可参考项目中的skills/diagram-design/SKILL.md和相关参考文件。
更多推荐

所有评论(0)