Community이미지github.com

research-architecture-figure

把论文里的研究框架、理论模型、技术架构、机制图、流程图绘制成可直接投稿的 SVG 架构图。Use when 用户说 画架构图、画框架图、画机制图、画技术路线图、画研究模型图、仿绘这张图、重画论文里的框架图、把这段文字画成结构图,或需要学术风格的 SVG/PNG 框图。Exclude 数据统计图(折线、柱状、森林图、ROC、热图,用统计绘图技能)、UML/ER/思维导图/PPT 版式类通用图、照片美化、文献检索与下载。

research-architecture-figure란 무엇인가요?

research-architecture-figure is a Claude Code agent skill that 把论文里的研究框架、理论模型、技术架构、机制图、流程图绘制成可直接投稿的 SVG 架构图。Use when 用户说 画架构图、画框架图、画机制图、画技术路线图、画研究模型图、仿绘这张图、重画论文里的框架图、把这段文字画成结构图,或需要学术风格的 SVG/PNG 框图。Exclude 数据统计图(折线、柱状、森林图、ROC、热图,用统计绘图技能)、UML/ER/思维导图/PPT 版式类通用图、照片美化、文献检索与下载。.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/huayu-pro/skills/tree/HEAD/research/research-architecture-figure

Installed? Explore more 이미지 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

科研架构图

把「一段研究逻辑」变成「一张能投出去的结构图」。默认产物是手写 SVG + 同名 PNG,因为中文小字只有矢量文本才不糊、可改、可复现——AI 生图在中文标签上不可靠。

技能沉淀自 150 张中文核心期刊架构图的逐张仿绘与验收。规范是三样东西:模板资产(37 个成品骨架,全部取自仿绘)、布局公式(坐标怎么算)、质检门禁(lint_svg.py 拦住零长度箭头、文字出框、白底缺角等已知翻车)。

三条不变式

改动任何模板之前先记住这三条,它们是处理未列举场景的推理依据。

  1. 结构先于美化。 先把「层级/流向/闭环/对照」定死,再谈配色。原图的骨架、层次、箭头方向必须还原;配色与对齐按本技能统一。不为好看改语义。
  2. 标签忠实原文。 术语、编号、英文缩写、型号等标注照抄,不换同义词、不合并。只修明显错别字;每个词都要能在原图或提纲里找到出处。
  3. 一图一主题。 顶层实体超过 8 个先分组,嵌套超过两层考虑拆图。宁可少画一个模块,不把图塞成文字墙。

三种入口

入口输入做法
仿绘原图(截图/PDF)判读结构 → 选模板 → 逐模块还原文字与层级;不重排原图逻辑,只统一风格
新绘描述、提纲、小节先写「一句话重点」→ 抽实体与关系 → 归入结构族 → 从模板起步
改图已有 SVG只改文字/增删模块 → 位置按等分公式重算,不局部挪动

新绘时只给一串名词的,先补关系(谁作用于谁、谁包含谁、先后),否则只是"词摆成框"。

六步工作流

  1. 判读结构:数层数、数环节、看箭头方向、找闭环。结构模糊时按「层级→流程→闭环→矩阵」试归族。
  2. 选模板:查路由表,从 assets/templates/index.json 取骨架;拿不准读 references/template-catalog.md。
  3. 定画布:按原图宽高比取整,常用 1200×800 / 1000×700 / 1400×500;四周留白 ≥40px;新增/改动的元素落在 8px 网格(模板既有坐标是语料原样,豁免)。图题不画进图内。
  4. 算布局:用 references/layout-recipes.md 的公式算等分、层带、居中基线,不要目测。文字先估宽再决定框宽。
  5. 写 SVG:复制模板,逐块替换文字与坐标;特殊图元从 references/svg-cookbook.md 粘。
  6. 渲染 + 质检:render_svg.py 出 PNG,lint_svg.py 跑静态检查,按「七项质检」目检。修完重跑,最多 3 轮。

结构路由表

结构族原图信号模板硬约束
层级/分层横向层带、技术分层TP01 TP06 TP11 TP12 TP13 TP25层 ≤6,每层 ≤6 模块
关系/机制因果链、支撑树、治理关系、潜变量路径TP02 TP03 TP07 TP10 TP14 TP17 TP27 TP29 TP31中心辐射 ≤8 条
流程/闭环循环、闭环、反馈、阶段推进TP04 TP05 TP19 TP20 TP21 TP22 TP23环上 3–6 节点
分解总—分、功能树TP09 TP24树 ≤3 级
评价指标体系、评估流程TP08 TP18维度 3–8
结构/其他矩阵、总线、关系网、集群、拓扑、多域TP15 TP16 TP26 TP28 TP30 TP32 TP33 TP34 TP35 TP36 TP37同层等距

每个模板的骨架与改法见 references/template-catalog.md 总表。

结构族不互斥:常见「上层分层 + 下层流程」,按主叙事选主模板,次结构用背景带承载。

设计令牌

项值
画布白底 #FFFFFF;按原图比例取整;留白 ≥40px;8px 网格
字体Noto Sans CJK SC, sans-serif(根 <svg> 声明一次,不写 <style>)
字号一级标题 16/700;模块标题 14–15/700;框内正文 13/400;注释 11/400 #666666
文字色默认 #1A1A1A;深色底用 #FFFFFF
圆角普通框 rx=6;背景带 rx=10;胶囊/药丸 rx=高/2
描边默认 1.5;强调框 2;次级连线 1.2–1.3
虚线边界/可选框 6 3;弱关联/反馈箭头 5 4
间距同层横向 24、纵向 20;层间 40 为公式缺省,套模板以该模板实测坐标为准

语义色板(每张图主色 ≤4 种,同层同色):

语义主色浅底
核心/主结构#2F6BB0#EEF4FB
次级/一般模块#4A86C5#F4F8FD
关键节点/输出#E8833A#FDF3EA
结果/成效#3E9B6C#EDF7F2
问题/约束#C94F44#FBF0EF
中性/背景带#8A94A6#F3F5F8

背景带用低透明度而不是实色:fill="#2F6BB0" fill-opacity="0.06"。完整色值与例外(深底反白、语义紫 #7B5EA7)见 references/style-spec.md。

布局计算

不要目测坐标,按公式算。完整配方(层带、树形、泳道、环形)见 references/layout-recipes.md;竖排与长英文标签的排法见 references/style-spec.md。

  • 等分模块宽:w = (内容区宽 - 间距 × (n-1)) / n,x_i = 左边界 + i × (w + 间距)。
  • 层带内容区:内左 = 带.x + 24,内宽 = 带.w - 48,模块高 72,模块顶 带.y + 56(+56 是公式缺省,各模板实测不同,套模板以实测为准)。
  • 框内文字垂直居中:单行基线 y = 框.y + 框.h/2 + 0.35 × 字号;两行时两基线围绕中心对称,行距 ≥1.5×字号。
  • 文本宽度估算:中文/全角 ≈ 1.0×字号,大写字母 ≈ 0.72×(W/M 0.9×),小写与数字 ≈ 0.55×,空格 0.3×;中文字串里的 ·、希腊字母等歧义宽字符按全角算。超过框宽 90% 必须用 <tspan> 手动换行——宁多一行,不挤一行。

连线与箭头

  • 语义:实线 = 直接影响/主流程;虚线 5 4 = 弱关联/反馈/间接影响;粗箭头/块箭头 = 支撑或资源流;双向 marker = 相互影响。
  • 颜色:默认 #5A6B7E;主流程可用 #2F6BB0;与框同色时箭头跟随该语义色。
  • marker 规范值(全库通用,直接复用):
<marker id="arrow" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7"
        orient="auto-start-reverse">
  <path d="M0,0 L10,5 L0,10 z" fill="#5A6B7E"/>
</marker>
  • 正交优先:用 H/V 或水平/竖直线段,拐点落在元素中线;禁止斜线穿越其他框。语义确为"作用于"的短斜箭头可以保留,但不许压到别的模块上。
  • 箭头起止于框边线,允许留 0–4px 防 marker 压线;同一张图内保持一致。
  • 连线标签 11px,放线段中点上方 4px,必要时垫白底。

七项质检

任何一项不过就回第 5 步。多数项 lint 有对应检查(图题仅识别「图N/Fig」前缀,重心靠目检);catalog 注明「原图设计」的既有 WARN(TP32–TP35、贴边 8px 组)豁免,不返工。最终以渲染 PNG 目检为准。

  • 文字压框线 / 出框 / 断字
  • 行距过挤(< 1.4×字号)
  • 同层模块不等高或间距不一致
  • 箭头穿越其他图元
  • 分组框与成员框间距 < 12px
  • 图面重心偏移(一侧大片留白)
  • 图题被画进图内

脚本

# 1) 静态质检:XML/marker/零长度箭头/白底覆盖/出框/行距/互压/穿框/同层/贴边/调色板
python3 scripts/lint_svg.py <svg文件或目录>
python3 scripts/lint_svg.py <目录> --json          # 机器可读,批量汇总
python3 scripts/lint_svg.py --self-test            # 确认检查规则本身会报错

# 2) 渲染 PNG + 拼版总览
python3 scripts/render_svg.py <svg文件或目录> --scale 2
python3 scripts/render_svg.py assets/templates --sheet /tmp/sheet.png

退出码:0 干净、1 有 FAIL(不要交付)、2 仅有 WARN。WARN 是估算不是判决,以渲染 PNG 为准。

批量模式

模板先保证量与合规,子代理再保证还原度。

  1. 按结构族轮转套模板,程序化生成合规 SVG。
  2. 拆给子代理对照原图精修,每人 4–5 张。
  3. 全部过 lint + render,抽检 20%,不合格整批全查。

交付

默认交付同名 .svg + .png(2 倍缩放)。渲染图和原图并排看一遍,缺陷与修法见 references/qc-checklist.md 对照表。

Reference Map

验证清单

  • 结构族判定有依据,模板选型与原图逻辑一致
  • 原图标签全在图上,术语未改写
  • 新增/改动的坐标落在 8px 网格(模板既有坐标豁免),同层等高、等距
  • 文字不超过框宽 90%,行距 ≥1.5×字号
  • 箭头不穿框,线型语义正确
  • lint_svg.py 无 FAIL;WARN 已逐条确认
  • 渲染 PNG 目检三项通过(字号 / 位置 / 文字与边框,见 qc-checklist)
  • 图内无图题,四周留白 ≥40px

관련 스킬