drawio-academic-skills

用途

本技能是 draw.io 的学术论文插图叠加层，用于在论文、学位论文、期刊和 IEEE/ACM 等会议场景下创建、编辑、复刻、校验和导出可发表的 draw.io 图。它把学术策略与门禁叠加在同级的 drawio 基础技能之上，本层负责学术策略、学术文档和论文示例，基础层负责所有共享执行能力（命令行、schema、渲染器、主题、参考文档、示例、样式预设、桌面端导出）。

主要能力

学术预检：在生成或编辑前确定发表场合与受众、图形类型（架构图 architecture、路线图 roadmap、工作流 workflow）、配色策略、标题/图例/说明、公式与文本保真需求、导出预期，并估算节点预算（超过目标需与用户确认拆分或简化策略）。
配色预检：在已知发表场合后，如用户未指定配色，提供单选的配色推荐（含色盲/灰度安全性说明与场合理由）；若用户已指定则直接映射，学术复刻时保留原图配色。
来源理解：从论文、参考图或纯文本提示中只提取图所需信息，并显式保留不确定项。
图表计划门：对由论文推导的复杂图或学术复刻工作，在渲染前给出简明的图表计划并等待确认；简单学术图可跳过。
任务路由：提供 academic-create、math-formula、edit、replicate、base-capabilities、stencil-heavy、style-preset、direct-xml-exception 等路由，按需加载对应文件。
创建流程：将图分类为架构图、路线图或工作流，先确认图表计划（确认后才预览），以 YAML 规范为权威来源，经基础层 CLI 校验与渲染，再自检导出产物。
编辑与复刻流程：优先编辑 .spec.yaml 边车文件；仅有 .drawio 时通过基础 CLI 导入。复刻图像/SVG 时保留文本框、标题、图例、公式、边标签、基线/偏移、字体族/字号/斜体状态、对齐与间距。
导出策略：期刊/IEEE 矢量投稿需显式导出 PDF（或 SVG），无桌面端时生成 diagrams.net URL 并如实报告缺失导出。
样式预设：优先使用本叠加层的用户预设（~/.drawio-academic-skills/styles/），其次使用基础层内置预设，且不得改动内置预设。

使用方式

本技能需与同级 drawio 基础技能配合使用，共享资源按相对路径解析，例如 CLI（../drawio/scripts/cli.js）、URL 回退（../drawio/scripts/runtime/diagrams-net-url.js）、schema、主题、调色板、参考文档与内置样式预设。若 ../drawio/scripts/cli.js 缺失，应停止并报告需要将基础技能安装在本叠加层旁，不得静默重建或复制基础资源。

学术默认设置示例（YAML）：

meta:
  profile: academic-paper
  figureType: architecture # architecture | roadmap | workflow
  theme: academic # or academic-color when color is acceptable
  palette: okabe-ito # from venue preflight; ieee-bw for IEEE print
  title: Caption-ready title
  description: One sentence explaining the figure intent
  legend: Required when symbols, colors, line styles, or icons need explanation
  print: { target: cn-thesis } # optional gate: cn-thesis | ieee-single | ieee-double

默认交付物：

<name>.drawio
<name>.png（300dpi，通过 draw.io Desktop；无桌面端时回退 <name>.svg）

中间工作目录（<name>.spec.yaml、<name>.arch.json、原始或规范化 YAML、诊断信息）。

创建流程中的命令示例：

node ../drawio/scripts/cli.js input.yaml figure.drawio --validate --write-sidecars --sidecar-dir .drawio-tmp/figure --strict-warnings
node ../drawio/scripts/cli.js input.yaml figure.png --validate --use-desktop

矢量导出示例：

node ../drawio/scripts/cli.js input.yaml figure.pdf --validate --use-desktop
node ../drawio/scripts/runtime/diagrams-net-url.js figure.drawio

适用场景

论文、学位论文、期刊与 IEEE/ACM 等会议图中的架构图、路线图与工作流图。
由论文、参考图或纯文本提示推导的学术图复刻与规范化。
需要公式（LaTeX、AsciiMath、MathJax）排版的学术图。
学术云/网络/AWS/Azure/GCP/Cisco/Kubernetes 等模板密集图。
期刊/IEEE 的矢量格式投稿。

限制

学术写作保持 YAML 优先、离线优先，绝不创建、要求或经由 .mcp.json、MCP 或在线后端。
默认学术最终交付为 .drawio 与 300dpi 的 .png（通过 draw.io Desktop）；无桌面端时 SVG 为离线回退，需报告回退且不得声称未产出的文件。
中间文件（.spec.yaml、.arch.json、原始 YAML、诊断）保存在项目本地工作目录（如 .drawio-tmp/<name>/），除非用户明确要求可复现的边车包。
优先对导出的 PNG（或回退 SVG）做论文可读性与视觉自检，存在导出产物时不得以浏览器或 Playwright 截图替代。
外部图像生成预览仅为可选概念预览，不替代 YAML、产物、边车或导出产物校验。
不得在用户的 .agents/skills/drawio 下创建或修改临时 JS 脚本；持久性修复应移植到同级基础技能源。
质量门要求：最终 .drawio 与 .png（或回退 .svg）与工作目录中的 .spec.yaml/.arch.json 一致；meta.profile 为 academic-paper 且 meta.figureType 为 architecture、roadmap 或 workflow；节点数满足预算；标签在论文/A4 比例下可读；公式使用官方定界符；混排中日韩与拉丁字符使用 Times New Roman + SimSun 字体栈；标题、图例、标注、公式与边标签不被裁剪或压在连接线上；颜色不是唯一语义载体；配色与场合决策一致；打印门（PALETTE_PRINT_GATE）清晰；视觉自检遵循同级基础层的视觉评审流程；所请求的桌面端导出已尝试或报告不可用；所引用的本地图像资源声明非空的 raster_reason、atomic_raster_unit: true 与 contains_reconstructable_content: false。
价格、收费、具体平台支持等事实暂未提供。

技能介绍

用途

主要能力

使用方式

适用场景

限制