前言¶
论文里的系统架构图、业务流程图、追溯链和技术路线图，往往在 Word 或绘图软件里手摆半天，改一版就要重排连线。导出成位图再插入文档，放大后边缘发糊，审稿修改时也很难保留可编辑源码。
下面介绍 SkillHub 上的 Agent Skill「结构示意图生成」（坐标 @user_8d26dabd/academic-figure-gen）。它把 Graphviz DOT 模板、学术向配色和 DOCX 插入流程写进 SKILL.md，让 Agent 按固定工作流从描述生成 DOT、渲染矢量图，并按技能内文档把图放进 Word。统计类图表应走同发布者的 academic-chart-gen，本 Skill 只负责概念性结构示意图。
这是什么¶
结构示意图生成（包名 academic-figure-gen，当前 SkillHub 版本 2.0.9）是基于 Graphviz DOT 的学术论文配图生成 Skill。来源为 SkillHub community，分类 design-media，发布者 user_8d26dabd（页面标注作者刘楠）。SkillHub 页面显示评分 100000、下载 1847；标签 requires_api_key=false，安装本 Skill 本身不需要 API Key。
它解决的是：在 Agent 会话里用五类预置 DOT 模板和三套审稿向配色，快速产出可修改的矢量配图，并可选通过 python-docx 按论文习惯插入 DOCX。
核心功能¶
技能 SKILL.md 与包内 README.md 中已写明的能力如下，安装后 Agent 会按这些引用文档执行。
五类图表模板¶
在 references/dot-templates.md 中提供 DOT 源码模板，占位符为 {{PLACEHOLDER}}：
| 编号 | 模板 | 典型用途 |
|---|---|---|
| 1 | 架构分层图 | 系统架构、网络分层 |
| 2 | 业务流程图 | 审批、操作步骤 |
| 3 | 工序追溯图 | 制造追溯、质量链 |
| 4 | 技术演进路线图 | 技术演进、版本迭代 |
| 5 | 数据流图 | 系统交互、接口设计 |
三套学术配色¶
references/color-schemes.md 描述三套方案：学术深蓝（默认）、色盲友好（README 称经 CUD 验证）、灰阶打印安全。技能强调色盲友好与灰阶打印兼容，便于审稿与印刷。
渲染与 DOCX 联动¶
- 渲染依赖本机 Graphviz（文档要求最低 2.44+，推荐 7.0+），常用命令为
dot -Tpng。 references/docx-integration.md说明用 python-docx、Pillow 将 PNG 插入 Word：宽约 11 cm 居中、图题宋体 10.5pt、编号与「逆向插入」防漂移等。
与邻接 Skill 的分工¶
技能内路由表明确：
- 架构图 / 流程图 / 追溯图 / 路线图 / 数据流图 → 本 Skill。
- 柱状图、散点图等真实数据统计图 →
academic-chart-gen。 - 仅支持 Graphviz DOT，不支持 DrawIO、Mermaid。
使用边界¶
SKILL.md 要求配图基于用户提供的真实系统描述，不得为不存在的方法伪造架构；概念图与实验数据图分开；输出须标注「AI 生成示意图」，用户对内容真实性负责。
安装与启用¶
1. 安装 SkillHub CLI（若尚未安装）¶
按 SkillHub 安装文档 检查或安装：
command -v skillhub && skillhub --version
未安装时可执行完整安装脚本（文档中的推荐方式）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2. 安装本 Skill 到当前 Agent 的 skills 目录¶
必须使用 --dir 指向当前客户端识别的 skills 目录，否则默认落在 ./skills/ 可能不被加载。官方搜索结果显示的安装命令为：
skillhub install academic-figure-gen --namespace user_8d26dabd --dir <你的 skills 目录>
常见路径（同一份安装文档）：
- Cursor：
~/.cursor/skills/ - Codex：
~/.codex/skills/或项目下.agents/skills/ - Claude Code：
~/.claude/skills/
也可把下面提示词发给支持 Skill 的 AI，让其按安装文档完成安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_8d26dabd/academic-figure-gen`。
安装完成后，重启或刷新 Agent，使 SKILL.md 进入技能列表。触发词包括「学术配图」「架构图」「流程图」「Graphviz」「把这张图画进 Word」等（见技能 frontmatter）。
3. 本机渲染与 DOCX 依赖（配图实际产出时需要）¶
Graphviz 与 Python 依赖不在 Skill 安装包里自动装好，需按 references/graphviz-setup.md 与 references/docx-integration.md 自行安装，例如：
dot -V
pip install python-docx Pillow
典型用法¶
包内 README.md 给出的可复现流程如下。Agent 启用本 Skill 后，也会引导你在 dot-templates.md 选模板、替换占位符并渲染。
# 1. 安装 Graphviz（见 references/graphviz-setup.md）
# 2. 选择一个模板并替换占位符
cp references/dot-templates.md my-diagram.dot
# 编辑 my-diagram.dot，替换所有 {{PLACEHOLDER}}
# 3. 渲染为 PNG（推荐 300 DPI）
dot -Tpng -Gdpi=300 my-diagram.dot -o figure1.png
# 4. 插入 Word 文档（见 references/docx-integration.md）
python insert_figure.py figure1.png "系统架构分层示意图" --doc manuscript.docx
在对话中的典型请求示例（技能 SKILL.md 示例节）：「请为我的系统架构画一张矢量图」——预期得到 Graphviz DOT 源码 与 渲染说明（及按需生成的 PNG / DOCX 步骤）。
五层快速入门（技能正文摘要）：
- 在
dot-templates.md选择图表类型 - 将
{{PLACEHOLDER}}换成实际节点与边文案 - 在
color-schemes.md选定配色 dot -Tpng input.dot -o output.png- 按
docx-integration.md插入 Word
适用场景与注意¶
适合谁：写论文、技术报告、学位论文，需要架构分层图、业务流程图、追溯链、技术路线图或数据流图，且希望保留 DOT 源码、输出矢量或高 DPI 位图的研究者与工程师。
限制与注意：
- 节点过多时技能建议分图（场景路由中提到超过约 20 个节点宜拆分；诊断里提到 >50 可能布局混乱）。
- 中文节点若乱码，需按技能诊断处理字体（如
fontname、中文包），见graphviz-setup.md。 - 统计图表、误差线、显著性标记不属于本 Skill，应使用
academic-chart-gen。 - Graphviz、Python 与
python-docx需在本机可用；Skill 主要提供流程、模板与 Agent 行为约定，不替代本地dot可执行文件。
结尾¶
「结构示意图生成」把 Graphviz 五类学术向模板、三套配色和 DOCX 插入说明收敛成一套 Agent 工作流，适合在写稿阶段反复改图、又要保持矢量可编辑的场景。官方 Skill 页与 API 入口：
- https://www.skillhub.cn/skills/user_8d26dabd/academic-figure-gen
- https://api.skillhub.cn/user_8d26dabd/academic-figure-gen
