drawio-chart

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 或图片插画，要明确说明，并建议改用更合适的方式 输出要求 默认返回生成文件路径 若执行了导出，同时返回导出文件路径 若存在假设、删减或结构调整，要用一句话说明