| name | drawio-chart |
| description | Draw.io 配图专家：用于生成和导出 `.drawio` 图表。在用户要求 draw.io、diagrams.net、流程图、架构图、时序图、ER 图、状态图、思维导图，或明确提到 `.drawio`、PNG、SVG、PDF 导出、技术文章配图时使用。默认输出专业技术风格，并遵循 floracat-architecture-diagram 的视觉规范。 |
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
生成时遵循这些顺序：
- 标题
- 容器 / 分组
- 核心节点
- 连线
- 标签与旁注
6. 导出或打开
- 用户要求导出时，再执行导出
- 用户只要求生成时，默认交付
.drawio
- 如果本机没有
drawio CLI，要明确告知无法自动导出，但 .drawio 已生成
多图文章模式
当用户给一篇文章并要求“生成多张技术配图”时，按这个规则处理：
- 先从文章中提炼 2-6 个最值得画图的结构
- 每个结构对应一个独立
diagram page
- 主文件名默认与文章文件名保持一致
- 页面名使用英文小写中划线命名
- 避免把整篇文章所有知识点挤进一张大图
更细的示例和 prompt 写法，读取 references/use-cases.md。
验证清单
交付前至少检查：
- 图表类型是否和任务匹配
- 主要节点是否齐全，关系是否画对
- 连线是否交代清楚方向和语义
- 文字是否简洁，没有把长句压在边上
mxCell.value 中是否混入 HTML 标签- 导出文件名是否符合命名规范
- 如果是多页文件，页面名是否清晰、一致
失败处理
- 如果用户需求过于模糊，先给出你推断的图表结构，再说明你的假设
- 如果导出失败，保留
.drawio，报告失败原因和可手动执行的导出命令
- 如果用户要求的内容更适合 Mermaid 或图片插画，要明确说明，并建议改用更合适的方式
输出要求
- 默认返回生成文件路径
- 若执行了导出，同时返回导出文件路径
- 若存在假设、删减或结构调整，要用一句话说明
