# Xml Diagram

> 根据自然语言描述生成 XML 格式（drawio）的图形文件。支持流程图、卡片、图表、图标等常用图形，输出可直接在 drawio 中打开编辑的 .drawio 文件。与 svg-generator 功能完全一致，但输出 drawio XML 格式。当用户提到 XML 绘图、drawio、生成图形、流程图时触发。

- **Type:** Skill
- **Install:** `agentstack add skill-bewatermyfriend7-skill-project-xml-diagram`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [BeWaterMyFriend7](https://agentstack.voostack.com/s/bewatermyfriend7)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [BeWaterMyFriend7](https://github.com/BeWaterMyFriend7)
- **Source:** https://github.com/BeWaterMyFriend7/SKILL-PROJECT/tree/main/.opencode/skills/xml-diagram

## Install

```sh
agentstack add skill-bewatermyfriend7-skill-project-xml-diagram
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# XML 图形生成器（drawio 格式）

## 核心工作流

```
用户描述 → 解析需求 → 设计图形 → 生成 drawio XML → 验证输出 → 保存文件
```

详细流程如下：
1. 接收用户描述
    - 用户可能会描述需要的图类型（流程图、卡片、图表等）、布局（横向、纵向、网格等）、内容（文字、emoji）和风格（简约，专业、可爱等）。
    - 解析用户输入，提取关键信息以指导后续的图形设计和生成。
2. 解析用户需求
    - 思考需要绘制的图类型、结构、元素、布局和配色，如果不清楚的情况，请用户确认。
    - 评估元素数量，合理分组，避免单个图形承载过多内容
3. 根据分析结果，设计图的布局和元素
    - 确定图的整体结构和层次关系
    - 设计每个元素的样式（颜色、形状、大小等）
    - 确定元素之间的连接方式（线条、箭头等）
4. 生成 drawio XML 代码
    - 使用 drawio 的 mxGraph XML 格式构建图形
    - 应用 CSS 样式内嵌到 SVG 中
    - 根据风格选择应用滤镜和阴影效果
5. 针对生成的图进行验证，确保其符合用户需求和预期的视觉效果
    - **背景模式确认**：
      - 确认用户选择的背景模式（浅色/深色）
      - 未明确时默认使用浅色背景
      - 深色模式下文字和边框使用浅色系
    - **基础结构验证**（避免元素重叠和布局错乱）：
      - 检查图的结构和元素是否正确
      - 确保所有节点坐标计算准确，无重叠
      - 验证连接线起点/终点精确指向节点边缘
      - 检查文字与图形边界间距 ≥8px，避免文字溢出
    - **布局规约验证**（避免空白过多和拥挤）：
      - 画布尺寸紧凑合理，利用率 60%-80% 为宜
      - 节点间距合理，无过大或过小
      - 分支路径清晰，无路径交叉
      - 折线转折点不与节点重叠
    - **显示完整性保障**（避免显示不完整）：
      - 计算画布尺寸：`画布高度 = 标题高度 + 内容总高度 + 节点间距 × (节点数-1) + 图例说明区高度(如有) + 边距`
      - 确保所有节点、文字、连线、箭头都在画布范围内
      - 各边保留 ≥30-40px 边距，避免内容被裁剪
    - **箭头与连接验证**（避免箭头混乱）：
      - 检查箭头样式统一
      - 验证箭头指向准确，无偏移或错位
      - 检查折线路径节点顺序正确，无交叉混乱
      - 验证虚线仅用于异步流程，错误分支使用实线
    - **稳健性设计检查**：
      - 避免使用嵌套坐标，所有坐标使用明确数值
      - 确保菱形判断节点中心坐标准确，分支从底部中心出发
      - 验证汇聚点位置在分支节点正下方，避免路径交叉
      - 图例应置于图形底部，避免与主流程重叠，预留专用图例区域
    - **样式与颜色验证**：
      - 确保颜色和样式符合选择的风格
      - 验证 drawio XML 代码的正确性和兼容性
      - 检查图的布局和元素之间的连接是否合理、线条是否清晰准确、图形是否清晰可读、颜色是否符合预期、排版是否整齐
      - 检查图中箭头是否清晰、连接是否正常、大小是否合适
      - 检查图片是否能够完整显示，是否有元素被截取
    - **复杂流程图验证**：
      - 分支流程使用不同颜色区分（错误分支用红色，主线用灰色/蓝色）
      - 条件判断节点使用菱形形状
      - 异步流程使用虚线连接（仅用于异步场景）
      - 汇聚点明确标注
      - 可选区域用虚线框表示
6. 输出最终的 drawio XML 文件，供用户使用和修改
    - 将 drawio XML 保存到指定路径，文件名以 `.drawio` 结尾
    - 提供 drawio XML 代码字符串供用户复制使用

**核心原则：生成的 drawio 图形要简洁美观，符合现代设计规范，与 svg-generator 风格保持一致。**

## 视觉风格规范

### 背景模式

**重要：生成图形时必须明确用户需要的背景模式，未明确时默认使用浅色背景**

#### 1. 浅色背景模式（默认）

适用于：浅色主题文档、PPT、网页等

参考示例：浅色流程图、浅色架构图

| 用途 | 颜色代码 |
|------|----------|
| 背景色 | `#f8f9fa` |
| 卡片背景 | `#ffffff` |
| 标题文字 | `#333333` |
| 正文文字 | `#666666` 或 `#999999` |
| 边框色 | `#e0e0e0` |
| 箭头颜色 | `#999999` 或 `#666` |

#### 2. 深色背景模式

适用于：深色主题文档、演示文稿、代码编辑器主题等

参考示例：深色流程图、深色时间线

| 用途 | 颜色代码 |
|------|----------|
| 背景色 | `#1a1a2e` |
| 卡片背景 | `#16213e` |
| 标题文字 | `#ffffff` |
| 正文文字 | `#aaaaaa` 或 `#888888` |
| 边框色 | `#333333` |
| 箭头颜色 | `#666666` 或 `#555555` |

**深色模式配色速查**：
| 用途 | 颜色代码 |
|------|----------|
| 主色（蓝） | `#3498db` |
| 成功（绿） | `#2ecc71` |
| 警告（橙） | `#e67e22` |
| 错误（红） | `#e74c3c` |
| 紫色 | `#9b59b6` |
| 青色 | `#1abc9c` |
| 黄色 | `#f39c12` |
| 青色2 | `#00cec9` |

**深色背景下的特殊处理**：
- 文字使用浅色系确保对比度
- 节点边框适当加粗（2-3px）以增强可见性
- 建议使用圆角卡片提升视觉层次

### 配色方案

| 用途 | 颜色代码 |
|------|----------|
| 主色（蓝色） | `#3498db` |
| 辅助色（绿色） | `#2ecc71` |
| 强调色（橙色） | `#e67e22` |
| 警示色（红色） | `#e74c3c` |
| 背景色 | `#f8f9fa` |
| 文字色 | `#333333` 或 `#666666` |
| 边框色 | `#e0e0e0` |
| 箭头颜色 | `#999999` 或 `#3498db`（灰色/蓝色） |

### 图形规范

| 项目 | 浅色模式默认值 | 深色模式默认值 |
|------|---------------|---------------|
| 画布尺寸 | 800×600 | 800×600 |
| 圆角半径 | 8px（卡片） | 8px（卡片） |
| 阴影 | 柔和阴影 | 无阴影或淡阴影 |
| 边框宽度 | 2px | 2-3px |
| 字体 | PingFang SC, Microsoft YaHei, sans-serif | PingFang SC, Microsoft YaHei, sans-serif |
| 线条粗细 | 2px | 2px |

### 布局规范（重要）

#### 1. 形状拼接规范（避免圆弧不协调）

**问题说明**：当一个形状内部包含另一个形状（如带标题栏的卡片）时，如果分别设置圆角会导致边界不协调。

**正确做法 - 使用单层结构**：
```xml

  

```

**简化设计原则**：
- 避免使用双层形状叠加（一个带圆角的矩形+一个矩形标题栏）
- 如需区分标题区域，使用颜色填充而非叠加形状
- 标题文字使用粗体或不同颜色区分，不单独创建标题块
- drawio 中直接使用 `fontStyle=1` 让文字加粗，或使用不同 `fontColor` 区分标题

#### 2. 线条布局规范（避免混乱与重叠）

**节点间距规则**：
- 横向节点间距：≥ 40px
- 纵向节点间距：≥ 30px
- 分支节点间距：分支点前垂直距离 ≥ 50px

**连接线规范**：
- 连接线端点距节点边界：≥ 5px
- 折线转折点：使用整数坐标
- 避免三条以上路径经过同一坐标点
- 优先使用直线，其次折线，谨慎使用曲线
- 使用 `edgeStyle=orthogonalEdgeStyle` 确保折线正交

**分支路径规则**：
- 双分支左右偏转角度：30-45°
- 分支展开角度合理，避免交叉
- 汇聚点位于所有分支节点的公共下方

**防重叠检查**：
- 连接线不穿过其他节点
- 文字与图形边界间距 ≥ 8px
- 图例与主流程保持 ≥ 30px 间距

## drawio XML 格式规范

### 基础结构

```xml

  
    
      
        
        
        
      
    
  

```

### 常用元素格式

#### 1. 浅色模式圆角矩形卡片

```xml

  

```

#### 2. 深色模式圆角矩形卡片

```xml

  

```

#### 3. 菱形判断节点

```xml

  

```

#### 4. 圆形节点

```xml

  

```

#### 5. 箭头连接线

```xml

  

```

#### 6. 虚线连接（异步/可选流程）

```xml

  

```

#### 7. 红色箭头（错误分支）

```xml

  

```

#### 8. 虚线框（可选区域）

```xml

  

```

#### 9. 汇聚点

```xml

  

```

### 样式属性说明

| 属性 | 说明 | 常用值 |
|------|------|--------|
| rounded | 圆角 | 0=无, 1=有 |
| whiteSpace | 文本换行 | wrap |
| html | HTML渲染 | 1 |
| fillColor | 填充颜色 | #ffffff, #16213e 等 |
| strokeColor | 边框颜色 | #3498db, #e74c3c 等 |
| strokeWidth | 边框宽度 | 2 |
| fontColor | 文字颜色 | #333333, #aaaaaa 等 |
| fontSize | 字体大小 | 12, 14, 16 等 |
| fontStyle | 字体样式 | 0=普通, 1=粗体 |
| dashed | 虚线 | 0=实线, 1=虚线 |
| shadow | 阴影 | 0=无, 1=有 |
| edgeStyle | 连线样式 | orthogonalEdgeStyle=正交, elbowEdgeStyle=肘部 |

### 分层架构图容器

```xml

  

  

```

## 执行步骤

### 第 1 步：解析用户需求

用户可能提供：
- **图形类型**：流程图、卡片、图表、图标、关系图、架构图
- **布局描述**：横向、纵向、网格、环形
- **内容**：文字、emoji、颜色偏好
- **风格**：简约、专业、可爱
- **背景模式**：浅色/深色（重要：必须明确，未明确时默认浅色）

### 背景模式确认

**关键步骤**：生成前必须确认用户需要的背景模式

1. 询问用户：「需要浅色背景还是深色背景的图？」
2. 如用户未指定，默认使用**浅色背景**
3. 适用场景参考：
   - 浅色背景：文档、PPT、网页展示
   - 深色背景：代码截图、IDE配套图、深色主题设计稿

### 第 2 步：选择模板或新建

常用模板：
1. **横向流程图** - 步骤从左到右排列
2. **纵向流程图** - 步骤从上到下排列
3. **循环流程图** - 首尾相连的闭环
4. **卡片网格** - 多张卡片并列
5. **对比图** - 左右对比布局
6. **时间线** - 垂直或水平时间轴
7. **饼图/柱状图** - 数据可视化
8. **架构图** - 系统、部署、应用架构图，架构图要分层显示
9. **表格对比** - 数据表格可视化

### 第 3 步：生成 drawio XML 代码

根据需求生成完整的 drawio 文件：

#### 浅色背景模板

```xml

  
    
      
        
        
        
        
        
          
        
        
        
        
          
        
        
        
        ...
      
    
  

```

#### 深色背景模板

```xml

  
    
      
        
        
        
        
        
          
        
        
        
        
          
        
        
        
        
        
          
        
        
        ...
      
    
  

```

**深色背景配色速查表**：
| 元素 | 颜色代码 |
|------|----------|
| 背景 | `#1a1a2e` |
| 卡片背景 | `#16213e` |
| 标题文字 | `#ffffff` |
| 正文文字 | `#aaaaaa` / `#888888` |
| 边框 | `#333333` |
| 箭头 | `#666` |
| 主色边框 | `#3498db` |
| 成功色 | `#2ecc71` |
| 错误色 | `#e74c3c` |

### 第 4 步：保存文件

将生成的 drawio 保存到用户指定的位置，文件名以 `.drawio` 结尾。

## 箭头规范

### 箭头样式

| 样式 | 属性值 |
|------|--------|
| 灰色箭头（推荐） | strokeColor=#999999 |
| 蓝色箭头 | strokeColor=#3498db |
| 红色箭头 | strokeColor=#e74c3c |
| 紫色箭头 | strokeColor=#9b59b6 |

### 线条样式

| 样式 | 使用场景 | 属性 |
|------|---------|------|
| 实线 | 主线流程、正确分支、错误分支 | dashed=0 |
| 虚线 | 异步/回调/可选流程 | dashed=1 |

**重要原则**：
- 错误分支必须使用实线，用颜色（红色）区分，不可用虚线
- 虚线仅用于表示异步、回调、定时任务等非同步场景

### 箭头端点样式

```xml

endArrow=classic;endFill=1;

endArrow=classicEmpty;endFill=0;

endArrow=diamond;endFill=1;
```

## 流程图规范

### 画布尺寸计算规则

```
画布高度 = 标题高度 + 内容总高度 + 节点间距 × (节点数-1) + 边距
画布宽度 = 边距 + 最大节点宽度 × 列数 + 列间距 × (列数-1) + 边距
```

### 节点排列

- 横向流程：节点水平排列，间距 40-60px
- 纵向流程：节点垂直排列，间距 30-50px

### 连接线类型

#### 直线连接
```xml

  

```

#### 折线连接（路径转向）
```xml

  
    
      
    
  

```

#### 曲线连接（循环/回退）
```xml

  

```

### 分支与汇聚

#### 菱形判断节点
```xml

  

```

#### 分支连线标注
在连线旁边添加标注：
```xml

  

```

## 架构图规范

### 分层结构

架构图应采用分层设计，从上到下：
1. 接入层（客户端、CDN、负载均衡、网关）
2. 服务层（业务服务、认证服务、消息队列）
3. 数据层（Redis、MySQL、MongoDB）
4. 基础层（Docker、K8s、监控）

### 架构图组件模板

#### 服务节点
```xml

  

```

#### 数据库节点
```xml

  

```

#### 队列节点
```xml

  

```

### 箭头使用规则

**分层架构图中箭头是可选的**：

1. **无箭头架构图**：当重点展示系统层次结构和组件分层时，可以不加箭头。

2. **带箭头架构图**：当需要表示数据流向、调用关系或处理顺序时，可添加箭头。箭头应使用统一灰色（#999999）。

```xml

  

```

## 验证清单

### 1. 背景模式确认

生成前必须确认：
- [ ] 已询问用户需要浅色还是深色背景
- [ ] 背景色与内容颜色形成良好对比
- [ ] 深色模式下文字使用浅色系（#ffffff、#aaaaaa、#888888）

### 2. 基础结构验证

- [ ] 节点圆角一致（rounded=1）
- [ ] 边框宽度适中（strokeWidth=2）
- [ ] 文字清晰可读，与背景对比度足够
- [ ] 箭头样式统一
- [ ] **形状拼接验证**：避免双层叠加导致的圆角不协调问题，使用单层结构
- [ ] **连接线验证**：确保连接线端点精确指向节点边缘，不偏移

### 3. 布局规约验证

- [ ] 画布尺寸合适，无过多空白（利用率 60%-80%）
- [ ] 节点间距合理，无拥挤或过大间距
- [ ] 分支路径清晰，无路径交叉
- [ ] 折线转折点不与节点重叠
- [ ] **防线条混乱验证**：
  - 避免三条以上路径经过同一坐标点
  - 连接线不穿过其他节点
  - 分支角度合理（30-45°），避免交叉
- [ ] 图例位于底部，与主流程无重叠

### 4. 图形完整显示验证

- [ ] 图形能够完整显示，避免元素超出画布范围
- [ ] 所有节点在画布范围内
- [ ] 连接线端点距节点边界距离合适
- [ ] 文字与图形边界间距足够

### 5. 颜色与样式验证

- [ ] 颜色符合配色规范
- [ ] 错误分支使用红色实线（非虚线）
- [ ] 异步流程使用虚线（紫色或灰色）
- [ ] 边框宽度合适（浅色模式：2px，深色模式：2-3px）

## 输出说明

生成的 drawio XML 文件可以直接：
1. 在 drawio 中打开查看和编辑
2. 保存为 .drawio 文件
3. 导出为 PNG、SVG、PDF 等格式
4. 嵌入到文档中使用

## 触发条件

当用户提到以下内容时触发：
- XML、drawio、绘图
- 流程图、关系图、结构图、架构图
- 生成一个图、把文字变成图
- drawio 编辑

## 与 svg-generator 的对应关系

本 skill 与 svg-generator 功能完全一致，区别在于输出格式：

| svg-generator | xml-diagram |
|---------------|-------------|
| 输出 SVG 格式 | 输出 drawio XML 格式 |
| `.svg` 文件 | `.drawio` 文件 |
| 可在浏览器打开 | 可在 drawio 中编辑 |
| 相同配色方案 | 相同配色方案 |
| 相同布局规范 | 相同布局规范 |
| 相同验证清单 | 相同验证清单 |

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [BeWaterMyFriend7](https://github.com/BeWaterMyFriend7)
- **Source:** [BeWaterMyFriend7/SKILL-PROJECT](https://github.com/BeWaterMyFriend7/SKILL-PROJECT)
- **License:** Apache-2.0

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-bewatermyfriend7-skill-project-xml-diagram
- Seller: https://agentstack.voostack.com/s/bewatermyfriend7
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.