代理人记录

4 79860 更新:2026-07-25

在 OpenClaw 代理创建的 PR/issue 工作流程中,向 GitHub PR 或 issue 正文添加经过编辑的代理记录部分。

安装
npx skills add https://github.com/openclaw/openclaw --skill diagram-maker
技能详情 readonly

OpenClaw diagram-maker 技能完整说明

路径:openclaw/tree/main/skills/diagram-maker,是 OpenClaw 官方内置全自动图表生成智能体技能,核心能力:自然语言/代码/文档一键转专业绘图代码 + 渲染可视化图表,全程由 Agent 自动调用,无需手动写 Mermaid/PlantUML。

一、核心工作流程

  1. 语义解析 接收三类输入:自然语言描述、业务文档、仓库代码结构/接口逻辑;LLM 自动提取节点、依赖、流程、分层关系。
  2. 生成标准绘图语法 输出主流图表标记语言:Mermaid(默认)、PlantUML、Graphviz DOT。
  3. 渲染导出 自动渲染成 SVG/PNG,保存到本地输出目录,同时返回可直接复制的源码,支持粘贴到 Typora、GitBook、Excalidraw、ProcessOn。
  4. 迭代优化 支持对话式修改:调整布局、增加分层、补充模块、切换图表类型,无需重新描述全部逻辑。

二、支持的图表类型(全覆盖技术/业务场景)

1. 开发技术类

  • 系统架构图、微服务拓扑、C4 分层架构
  • UML:时序图、类图、用例图、状态机
  • 数据库 ER 实体关系图
  • 接口调用链路、请求流程图、部署拓扑
  • 项目目录结构树、代码依赖图谱

2. 业务流程类

  • 业务流程图、审批流程、用户操作路径
  • 泳道图(BPMN)、状态流转图
  • 甘特图(项目排期、迭代计划)
  • 思维导图、知识脑图、技术学习路线

3. 数据&汇报类

  • 饼图、柱状图、漏斗图、时间轴
  • 对比矩阵、模块关系图、组织架构图

三、核心功能亮点

  1. 代码仓库自动识图 搭配 github/code-analyze 技能,可扫描整个项目源码,自动生成系统架构、模块依赖、数据库 ER 图,新人接手项目不用手动梳理结构。
  2. PR/文档联动自动插图 配合之前的 autoreview 代码评审技能:评审时自动生成调用链路图、逻辑流程图,插入 PR 评论,直观展示问题代码的执行路径。
  3. 无感知自动触发 Agent 识别到你需求画图、梳理架构、梳理流程时,自动启用 diagram-maker,不用手动输入指令调用。
  4. 文档配套输出 同时输出 Markdown 文档 + 图表源码 + 图片文件,可直接放进项目 README、技术方案、接口文档。
  5. 轻量化无额外依赖 内置 Mermaid 渲染引擎,无需本地安装绘图软件,Linux/macOS/Windows 全平台兼容。

四、典型使用场景

  1. 写技术方案:一句话描述微服务架构,自动出分层架构图
  2. 代码评审:梳理复杂接口调用时序,生成时序图辅助排查逻辑漏洞
  3. 项目文档:扫描仓库代码自动生成 ER 图、模块依赖图更新 README
  4. 业务梳理:把长篇需求文档转标准业务流程图
  5. 项目管理:生成迭代甘特图、任务依赖脑图

五、与同类绘图技能区分

  1. diagram-maker(官方内置):开箱即用,深度和 OpenClaw 代码/PR/文件读取能力打通,适合开发全流程自动化插图;
  2. 第三方 excalidraw-diagram:仅输出 Excalidraw JSON,需要手动粘贴网页查看;
  3. chartgen:侧重数据统计图表(柱状/饼图),不支持架构、时序、流程图。

六、依赖前置

需启用 OpenClaw 基础文件读取、代码解析技能;若要读取 GitHub 仓库自动生成架构图,需搭配 github 技能。