OpenClaw diagram-maker 技能完整说明
路径:openclaw/tree/main/skills/diagram-maker,是 OpenClaw 官方内置全自动图表生成智能体技能,核心能力:自然语言/代码/文档一键转专业绘图代码 + 渲染可视化图表,全程由 Agent 自动调用,无需手动写 Mermaid/PlantUML。
一、核心工作流程
- 语义解析 接收三类输入:自然语言描述、业务文档、仓库代码结构/接口逻辑;LLM 自动提取节点、依赖、流程、分层关系。
- 生成标准绘图语法 输出主流图表标记语言:Mermaid(默认)、PlantUML、Graphviz DOT。
- 渲染导出 自动渲染成 SVG/PNG,保存到本地输出目录,同时返回可直接复制的源码,支持粘贴到 Typora、GitBook、Excalidraw、ProcessOn。
- 迭代优化 支持对话式修改:调整布局、增加分层、补充模块、切换图表类型,无需重新描述全部逻辑。
二、支持的图表类型(全覆盖技术/业务场景)
1. 开发技术类
- 系统架构图、微服务拓扑、C4 分层架构
- UML:时序图、类图、用例图、状态机
- 数据库 ER 实体关系图
- 接口调用链路、请求流程图、部署拓扑
- 项目目录结构树、代码依赖图谱
2. 业务流程类
- 业务流程图、审批流程、用户操作路径
- 泳道图(BPMN)、状态流转图
- 甘特图(项目排期、迭代计划)
- 思维导图、知识脑图、技术学习路线
3. 数据&汇报类
- 饼图、柱状图、漏斗图、时间轴
- 对比矩阵、模块关系图、组织架构图
三、核心功能亮点
- 代码仓库自动识图 搭配 github/code-analyze 技能,可扫描整个项目源码,自动生成系统架构、模块依赖、数据库 ER 图,新人接手项目不用手动梳理结构。
- PR/文档联动自动插图 配合之前的 autoreview 代码评审技能:评审时自动生成调用链路图、逻辑流程图,插入 PR 评论,直观展示问题代码的执行路径。
- 无感知自动触发 Agent 识别到你需求画图、梳理架构、梳理流程时,自动启用 diagram-maker,不用手动输入指令调用。
- 文档配套输出 同时输出 Markdown 文档 + 图表源码 + 图片文件,可直接放进项目 README、技术方案、接口文档。
- 轻量化无额外依赖 内置 Mermaid 渲染引擎,无需本地安装绘图软件,Linux/macOS/Windows 全平台兼容。
四、典型使用场景
- 写技术方案:一句话描述微服务架构,自动出分层架构图
- 代码评审:梳理复杂接口调用时序,生成时序图辅助排查逻辑漏洞
- 项目文档:扫描仓库代码自动生成 ER 图、模块依赖图更新 README
- 业务梳理:把长篇需求文档转标准业务流程图
- 项目管理:生成迭代甘特图、任务依赖脑图
五、与同类绘图技能区分
- diagram-maker(官方内置):开箱即用,深度和 OpenClaw 代码/PR/文件读取能力打通,适合开发全流程自动化插图;
- 第三方 excalidraw-diagram:仅输出 Excalidraw JSON,需要手动粘贴网页查看;
- chartgen:侧重数据统计图表(柱状/饼图),不支持架构、时序、流程图。
六、依赖前置
需启用 OpenClaw 基础文件读取、代码解析技能;若要读取 GitHub 仓库自动生成架构图,需搭配 github 技能。