drawio-academic-skills

Draw.io 学术叠加层

在同级 Draw.io Base Skill 的基础上应用学术规范，创建、编辑、复刻、验证并导出可用于出版的 draw.io 图表。此叠加层刻意保持精简：它负责学术规范与门槛、学术文档和论文示例；同级基础技能 ../drawio 负责所有共享执行功能（CLI、架构、渲染器、主题，包括 academic/academic-color、参考资料、示例、样式预设和 Desktop 导出）。

必需的同级基础技能

相对于此叠加层目录解析共享资源：

• CLI ../drawio/scripts/cli.js；URL 备用路径 ../drawio/scripts/runtime/diagrams-net-url.js
• 架构 ../drawio/assets/schemas/spec.schema.json；主题 ../drawio/assets/themes/；调色板 ../drawio/assets/palettes/
• 参考资料 ../drawio/references/docs/、../drawio/references/official/、../drawio/references/workflows/、../drawio/references/examples/；共享返工规范 ../drawio/references/workflows/visual-review.md
• 内置样式预设 ../drawio/styles/built-in/

叠加层本地资源：references/docs/publication-overlay.md、academic-figure-playbook.md、academic-export-checklist.md、references/examples/、references/templates/。

如果缺少 ../drawio/scripts/cli.js，请停止并说明必须将同级基础技能安装在此叠加层旁边；绝不可悄悄在叠加层中重新创建或复制基础资源。

不可妥协的规范

• 学术创作必须以 YAML 为先、以离线为先。绝不可创建、要求或通过 .mcp.json、MCP 或实时后端来完成。
• 将 .drawio 和 300dpi 的 .png（通过 draw.io Desktop 导出）视为默认的学术最终交付物；没有 Desktop 时，SVG 是离线备用方案——须说明使用了备用方案，绝不可声称生成了实际未生成的文件。
• 将 .spec.yaml、.arch.json、原始 YAML 和诊断信息保存在项目本地工作目录中，例如 .drawio-tmp/<name>/，除非用户明确要求在最终输出旁提供可复现的附属文件包。
• 首先针对导出的 PNG（或备用 SVG）进行论文可读性和视觉自检。若已有导出产物，不要用浏览器或 Playwright 截图替代。
• 使用同级基础技能的 ../drawio/references/workflows/visual-review.md 处理预览结构、问题记录、YAML 优先的返工和停止规则；此叠加层仅增加出版检查。
• 外部图像生成预览仅可作为可选的概念预览。它们绝不可替代 YAML、产物、附属文件或导出产物验证。
• 不要在用户项目本地的 .agents/skills/drawio 下创建或修改临时 JS 脚本；应将持久有效的修复移植到同级基础技能源代码中。

学术预检

生成或编辑之前，确定并说明：发表场合／受众；图表类型（architecture、roadmap 或 workflow）；配色规范；标题说明／图例／标题、公式和文本保真度要求；导出预期。估算节点预算（权威目标、阈值和拆分策略：references/docs/academic-figure-playbook.md § Node Budget Management）；若超出目标，先与用户确认拆分或简化策略，再从 references/templates/ 中的紧凑样式开始。完整决策详情：references/docs/publication-overlay.md § Required Academic Decisions。

配色预选

确定场地后，如果用户没有指定配色，请使用 AskUserQuestion 创建单选项：将场地推荐方案放在首位，并标注 (Recommended)；提供 3-4 个选项，每个选项以配色的 displayName 作为标签，并在描述中说明色盲／灰度安全性及场地选择理由。场地映射表：references/docs/academic-figure-playbook.md § Venue Palette Mapping。

如果用户已经指定配色或明确的风格，请直接映射，不要提问。对于学术复现，请保留源配色并跳过选择，除非用户明确要求统一配色。将选定的名称记录在 meta.palette 中。完成报告必须注明配色及其色盲／灰度安全标记，包括任何印刷门槛降级情况。

理解来源

仅从论文、参考图像或纯文本提示中提取图表所需的信息；明确标注不确定之处。参见 references/docs/publication-overlay.md § Source Understanding 和 references/docs/academic-figure-playbook.md § Scientific Figure Patterns。

图表方案确认关卡

对于复杂的论文衍生图表或学术图像复现工作，请先提交简洁的图表方案，并等待确认后再渲染；简单的学术图表可以跳过此关卡。模板：references/docs/publication-overlay.md § Diagram Plan Gate。

可选图像预览

仅在图表方案获确认后进行；发送未发表或敏感内容前，必须先获得隐私许可。请将生成的文本视为近似内容，并在 YAML 中修正最终标签／公式／几何结构。完整规则：references/docs/publication-overlay.md § Optional Image Preview。

任务路由

选择一种路由，然后仅加载其文件。overlay = 此目录；base = 从此目录解析出的同级目录。

• academic-create — 论文、学位论文、IEEE、手稿、期刊、出版就绪图表 → overlay references/docs/publication-overlay.md、academic-figure-playbook.md、academic-export-checklist.md；base ../drawio/references/workflows/create.md
• math-formula — 公式、方程、LaTeX、AsciiMath、MathJax、公式 → base ../drawio/references/docs/math-typesetting.md、design-system/formulas.md
• edit — 修改学术套件或导入的 .drawio → base ../drawio/references/workflows/edit.md、../drawio/references/docs/migration-readiness.md
• replicate — 重绘截图、图像、SVG 或参考论文图表 → overlay references/docs/publication-overlay.md；base ../drawio/references/workflows/replicate.md、../drawio/references/docs/design-system/specification.md、color-guide.md
• base-capabilities — 代码／配置／实时导入、栅格提取、本地 PNG/JPEG 资源、多页套件、AI/SysML/BPMN 图形库，或出版检查前的离线后处理 → base ../drawio/references/docs/upstream-capability-compatibility.md、local-image-assets.md；overlay references/docs/publication-overlay.md
• stencil-heavy — 学术云、网络、AWS、Azure、GCP、Cisco、Kubernetes 图表 → base ../drawio/references/docs/stencil-library-guide.md、ieee-network-diagrams.md、../drawio/references/official/xml-reference.md
• style-preset — 学习／使用／列出／删除／重命名视觉样式预设 → base ../drawio/references/docs/style-extraction.md、style-presets.md、../drawio/styles/built-in/
• direct-xml-exception — 仅用于小型交接的 XML 或精确的 mxGraph 控件 → base ../drawio/references/upstream/pure-drawio-skill.md、../drawio/references/official/xml-reference.md

学术默认设置

对于学术论文相关请求，请在渲染前设置以下内容：

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 导出；若没有 Desktop，则回退为 <name>.svg）

中间工作目录：

• <name>.spec.yaml、<name>.arch.json、原始或规范化 YAML、诊断信息

期刊 / IEEE 矢量提交时，请明确导出 <name>.pdf（或 .svg）——必须使用矢量格式，不能使用栅格 PNG。其他格式仅在用户要求时提供。

创建流程

1. 将图表归类为 architecture、roadmap 或 workflow；对于基于论文且较复杂的请求，先确认图表计划（确认后再预览）。
2. 起草或规范化 YAML 规范，将其作为规范来源；缩小字体前先缩短标签。
3. 通过同级基础 CLI 验证并渲染，然后在报告前对导出的文件进行自检：

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

图表类型模式：references/docs/academic-figure-playbook.md。

编辑和复刻流程

• 先编辑 .spec.yaml 旁文件；如果只有 .drawio，则通过基础 CLI 导入（--input-format drawio --export-spec）。
• 对于图像 / SVG 复刻，如果可见，请保留文本框、标题、图例、公式、边缘标签、基线 / 偏移量、字体系列 / 字号 / 斜体状态、对齐方式和间距；独立的文本 / 公式块使用明确的 bounds，不在连线上方的连接器标签使用 labelOffset。
• 重新生成的文件应使用相同的基本文件名，以便工件和旁文件可往返转换。

导出策略

矢量提交（期刊 / IEEE）应明确导出 PDF（或 SVG）。没有 Desktop 时，生成 diagrams.net URL，并如实说明缺少的导出内容：

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

样式预设

优先使用覆盖层专属的用户预设（~/.drawio-academic-skills/styles/），其次使用同级基础包中的预设（../drawio/styles/built-in/）。切勿修改基础包中的预设；编辑或设为默认项前，先复制到用户预设目录。

质量门槛

在满足以下条件前，不要声称已完成：

• 最终 .drawio 和 .png（或回退使用的 .svg）与工作目录中的 .spec.yaml / .arch.json 一致；meta.profile 为 academic-paper，且 meta.figureType 为 architecture、roadmap 或 workflow
• 节点数量符合图表手册预算（references/docs/academic-figure-playbook.md § Node Budget Management）；超出时拆分或简化
• 标签在论文 / A4 尺寸下清晰可读；公式使用官方定界符（$$...$$、\(...\)、AsciiMath 反引号）；字体类别遵循字号阶梯，且没有标签适配溢出警告
• 混合 CJK / Latin 标签使用 Times New Roman + SimSun 字体栈（主题 cjk 字体栈或 meta.font）
• 标题、图例、标注、公式和边缘标签均未被裁切或放置在连接线上；图例简洁紧凑（使用单个多行文本节点）
• 颜色不是表达含义的唯一方式；meta.palette 符合出版场所的选择；PALETTE_PRINT_GATE 状态明确——严格印刷安全检查未通过时，提供 ieee-bw / tol-high-contrast
• 在任何实时 / 浏览器预览之前，已按照同级基础 ../drawio/references/workflows/visual-review.md 对导出的 PNG（或回退使用的 SVG）进行视觉自检；学术检查还需涵盖 A4 可读性、标题 / 图例、公式、印刷场景下的含义及出版场所要求
• 已尝试执行所需的 Desktop 导出，或报告无法执行；不需要 MCP 配置、服务或实时后端
• 引用的本地图像资源声明了非空的 raster_reason、atomic_raster_unit: true 和 contains_reconstructable_content: false

完成报告

最后提供简洁报告：交付内容及路径；生成旁文件时的中间工作目录；运行过的同级基础 CLI 命令；所选调色板、其色盲 / 灰度安全标记及任何印刷门槛降级情况；无法使用的 Desktop 导出及提供的回退内容；仍需进行的出版场所专项人工检查。