drawio-chart

# Draw.io 配图专家

这个 skill 负责把用户的图表需求转成 `.drawio` 文件，并在需要时导出为 PNG、SVG 或 PDF。

主文件只保留任务路由、工作流和验收规则。详细样式、XML 模板、导出命令和示例按需读取 `references/`。

## 什么时候使用

在这些场景下优先使用本 skill：

- 用户明确要求 `draw.io`、`diagrams.net` 或 `.drawio`
- 用户要求生成流程图、架构图、时序图、ER 图、状态机图、思维导图
- 用户希望把图导出为 PNG / SVG / PDF
- 用户要给技术文章、教程、系统设计文档配图
- 用户给出一篇文章，希望抽取多张技术图并放进同一个 draw.io 文件

不适合本 skill 的情况：

- 用户只想要 Mermaid 代码，不需要 `.drawio`
- 用户需要的是位图插画、海报或白板风正文配图，而不是结构化图表
- 用户只是讨论图表思路，还不想真正生成文件

## 参考路由

按任务需要读取对应参考文件，不要默认把所有参考内容都塞进上下文：

| 需求 | 读取文件 |
| --- | --- |
| 颜色、字体、节点语义、连线风格、视觉统一规范 | `references/style-spec.md` |
| XML 结构规则、文本标签规则、节点/连线模板、不同图表类型的结构建议 | `references/xml-and-layout.md` |
| 导出命令、文件命名、打开方式、交付规则 | `references/export-and-files.md` |
| 常见提示词、单图/多图文章配图示例、批量页面生成方式 | `references/use-cases.md` |

## 核心规则

- 默认先生成 `.drawio` 原生文件，再根据用户要求决定是否导出。
- 如果用户明确要求导出 PNG / SVG / PDF，仍然先保留 `.drawio` 作为源文件，除非用户明确要求删除。
- 输出图表时，优先保证信息结构清晰，再保证视觉统一，不要为了“好看”牺牲可读性。
- 图表中的 `mxCell.value` 默认使用纯文本，避免嵌入 HTML 标签。
- 连线标签保持短小；长说明优先放到节点里或旁注节点里。
- 能不解释基础概念就不解释，把上下文留给真正影响绘图结果的约束。

## 图表类型选择

按内容结构选择图表，不要机械套模板：

- 流程步骤、决策分支、算法逻辑：流程图
- 模块关系、服务依赖、部署层次：架构图
- 服务调用、消息交互、时序过程：时序图
- 实体、字段、主外键关系：ER 图
- 生命周期、状态迁移、事件驱动：状态机图
- 概念梳理、知识组织、层级扩展：思维导图

如果用户指定了图表类型，优先按用户要求执行；只有在用户明显选错图表类型时，才简短提醒并给出替代建议。

## 工作流

### 1. 识别任务模式

先判断当前属于哪一种：

- 单张图生成
- 单张图生成并导出
- 一篇文章生成多张图
- 修改已有 `.drawio`

### 2. 收集最小必要输入

至少明确这些信息：

- 图表主题
- 目标图表类型
- 关键节点 / 模块 / 实体 / 步骤
- 节点之间的关系
- 是否需要导出，以及导出格式

如果用户信息不完整，但可以合理推断，就直接推断并在结果里说明；只有缺少关键结构信息时才追问。

### 3. 读取对应参考资料

- 需要统一视觉风格时，读取 `references/style-spec.md`
- 需要生成 XML 或判断布局时，读取 `references/xml-and-layout.md`
- 需要导出或命名时，读取 `references/export-and-files.md`
- 需要给用户展示常见 prompt 或文章配图模式时，读取 `references/use-cases.md`

### 4. 先规划，再生成

生成前先在内部明确：

- 采用哪种图表类型
- 页面是一张图还是多个 `diagram page`
- 节点分组如何布局
- 哪些连线需要标签，哪些不需要

不要一边写 XML 一边临时想结构。

### 5. 生成 `.drawio`

生成时遵循这些顺序：

1. 标题
2. 容器 / 分组
3. 核心节点
4. 连线
5. 标签与旁注

### 6. 导出或打开

- 用户要求导出时，再执行导出
- 用户只要求生成时，默认交付 `.drawio`
- 如果本机没有 `drawio` CLI，要明确告知无法自动导出，但 `.drawio` 已生成

## 多图文章模式

当用户给一篇文章并要求“生成多张技术配图”时，按这个规则处理：

- 先从文章中提炼 2-6 个最值得画图的结构
- 每个结构对应一个独立 `diagram page`
- 主文件名默认与文章文件名保持一致
- 页面名使用英文小写中划线命名
- 避免把整篇文章所有知识点挤进一张大图

更细的示例和 prompt 写法，读取 `references/use-cases.md`。

## 验证清单

交付前至少检查：

- 图表类型是否和任务匹配
- 主要节点是否齐全，关系是否画对
- 连线是否交代清楚方向和语义
- 文字是否简洁，没有把长句压在边上
- `mxCell.value` 中是否混入 HTML 标签
- 导出文件名是否符合命名规范
- 如果是多页文件，页面名是否清晰、一致

## 失败处理

- 如果用户需求过于模糊，先给出你推断的图表结构，再说明你的假设
- 如果导出失败，保留 `.drawio`，报告失败原因和可手动执行的导出命令
- 如果用户要求的内容更适合 Mermaid 或图片插画，要明确说明，并建议改用更合适的方式

## 输出要求

- 默认返回生成文件路径
- 若执行了导出，同时返回导出文件路径
- 若存在假设、删减或结构调整，要用一句话说明