Community图像github.com

关系示意图生成

生成或编辑科学实体关系示意图(机制图、通路链、实验工作流、结构包含关系),输出可追溯、可编辑的 SVG 格式,并附带经过验证的关系语义。

关系示意图生成 是什么?

该技能专为需要生成或编辑科学研究中实体关系示意图的任务而设计,例如机制图、信号通路、实验工作流或结构包含关系。其核心区别在于通过严格的验证流程确保科学准确性,避免常见的 AI 图像生成错误,如将抑制错误绘制为激活、上下游关系颠倒、包含关系绘制为并列方框、发明基因名称或数字、以及无法追溯的主张。它要求首先从源材料中提取带有证据引用的实体-关系表格,然后基于此表格生成分层的 SVG 图形,再通过读取生成的图形来验证每个关系类型、方向和包含关系是否正确。最终输出可编辑的 SVG、300 DPI 的 PNG 和矢量 PDF。它主要适用于任何需要根据论文或案例材料绘制准确机制、工作流或关系图形的任务。该技能支持在 Claude Code、Cursor 等 AI 编码代理环境中运行,通过 Python 脚本实现完整工作流,并强调在绘图前必须构建一个带有证据引用的模型文件(model.json)作为唯一真实来源。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/qingyulzx/pku-efficiency3-skills/tree/HEAD/relationship-schematic

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

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

关系示意图:提取 → 建模 → 渲染 → 验证 → 导出

你正在绘制的图形的科学正确性将由一个 LLM 审查者对照源材料进行评判。通用图像生成的主要失败模式正是此技能拒绝执行的内容:抑制绘制为激活、上下游颠倒、包含关系绘制为并列方框、发明的基因名称或数字、无法追溯的主张。此处的每一种机制都是为了确保这些失败无法在未察觉的情况下被交付。

不可协商的原则

  1. 表格中不存在的内容,绝不绘制。 图形模型(model.json)是唯一的真实来源;SVG 是根据它生成的,并会对照它进行回读验证。
  2. 每个实体和关系都必须附带源材料中的逐字引用+定位信息。没有引用依据的关系会被工具拒绝(relation_no_evidence)。如果你无法引用它,你就不能绘制它。
  3. from/to 编码的是陈述内容,而非布局。 “A 抑制 B” ⇒ from: A, to: B, type: inhibits。渲染器负责几何布局;验证器负责检查箭头尖端确实落在 B 上。
  4. 未知情况就绘制为未知。 如果材料未说明方向,请使用 direction: "unknown" —— 它会以虚线加 ? 渲染,并在 result.json 中被标记。切勿为了图形美观而进行猜测。
  5. 首先交付保底的 result.json,之后再改进。 在步骤 1,在任何抽取之前,会写入一个包含明确空值的契约式框架,这样即使崩溃也能留下一个有效的部分可交付物。

脚本位于 scripts/ 目录下(纯 Python 3 标准库 + 可选的 cairosvg/PIL;自动检测浏览器无头模式以进行导出)。符号语义位于 symbols/symbols.json 中,并记录在 references/symbol-conventions.md 中;模型格式位于 references/model-schema.md 中。在首次运行前,请阅读这两个参考文件。

工作流程(7 步)

在 /app/work 目录下工作;最终产物放在 /app/output 目录下。

步骤 1 — 搭建最低可交付成果的框架

python scripts/init_result.py --case /input/case.json --work /app/work --output /app/output

读取案例,创建目录,写入 /app/output/result.json,其中每个 output_contract 字段都存在且为 null,status: "partial",并包含 partial_reasons 条目。如果案例文件缺失或无法读取,它仍会写入框架并记录问题。同时,你自己也要阅读 task.md 和任何材料文件 —— 切勿仅根据标签或文件名来假设内容。

步骤 2 — 提取实体-关系表格(依靠你的判断,而非脚本)

阅读实际材料(通过平台工具获取的 PDF 文本、表格、案例文本),并根据 references/model-schema.md 构建 /app/work/model.json:

  • 每个科学参与者作为一个实体;label = 源材料中印刷的规范名称;type = 以小副标题形式显示的功能角色;
  • 每个已陈述的交互作为一个关系,type 来自符号库(activates inhibits binds modifies transports indirect precedes contains parallels),direction 为(A_to_B / B_to_A / bidirectional / unknown);
  • 包含关系(“X 复合体由 A、B、C 组成”)成为一个包含成员的 group,加上 contains 关系 —— 绝不使用边,也绝不并列放置;
  • 时间/过程顺序(“首先……然后……”)变成带有步骤标签的 precedes 关系;
  • evidence = 材料的逐字子字符串 + 定位信息(章节、段落、表格行、页码)+ 来源 ID(DOI/文件名)。

针对复杂情况的提取规则:

  • 实体歧义(同义词/缩写,如“β-catenin” vs “CTNNB1”):视为一个实体,标签使用源材料中打印的名称,在 result.json 的 uncertainty 中注明等价关系。源材料区分了两个名称,则保留为两个实体。
  • 未明确的方向:使用 direction: "unknown"(虚线 + ?)。在 uncertainty 中说明歧义;不要通过“合理性”来解决它。
  • 间接证据(对于 X→Y 的主张,材料说“X 通过 Z 导致 Y”):对于 X→Y 的声明,使用类型 indirect(虚线)或者模拟机制链 X→Z→Y(如果每一步都有引用)。优先选择机制链 —— 审查者可以跟踪它。
  • 材料中的数字/单位/浓度(例如“3.3–10.4%”):按照打印的确切内容保留在边/节点标签中,绝不四舍五入或发明。
  • 如果案例要求的是 实际数据值的图表,这超出了本技能的核心范围(统计图表)—— 仍然交付适用的部分(实体表、数据到图例的映射规范),并将剩余部分标记为部分完成并说明原因。

步骤 3 — 在绘制前进行验证

python scripts/model_check.py /app/work/model.json

退出代码 0 = 干净(允许警告)。修复每个错误 —— 无论如何,渲染器在有错误时会拒绝渲染。警告(entity_no_evidence,direction_uncertain,cycle_in_rank_graph,……)是合理的科学状态:保留它们并将它们带入 result.json,而不是通过“发明”来“修复”它们。

步骤 4 — 渲染可编辑的 SVG

python scripts/make_schematic.py /app/work/model.json -o /app/work/figure.svg --report /app/work/layout.json

生成分层的 SVG:node-* / edge-* / group-* / legend 组,每个组都带有 data-evidence-quote/-locator/-source 属性。布局是自动化的(最长路径分层,因此 A_to_B 边向下指向);如果内容超过 canvas_width,画布会加宽并记录 canvas_expanded 警告 —— 任何内容都不会被裁剪。

步骤 5 — 回读图形并进行验证

python scripts/verify_svg.py /app/work/model.json /app/work/figure.svg --out /app/work/verify.json

这是核心的抗失败门禁。它检查实体/关系覆盖率、根据符号库检查标记语义、几何箭头方向(尖端必须比源节点更接近语义目标节点)、包含框是否实际包含成员(且不困住非成员)、节点重叠、标签适配度和图例覆盖率。退出代码 0 = 通过。

如果验证失败:修复 模型或编辑,重新渲染,重新验证。切勿手动修补 SVG 以使检查静默。两次迭代是正常的;如果由于材料矛盾而无法通过检查,则保留引用所支持的图形,并在 result.json 的 uncertainty 中记录冲突。

步骤 6 — 导出和合规性检查

python scripts/export_svg.py /app/work/figure.svg -o /app/output --pdf

将 <name>_300dpi.png 和 <name>.pdf 写入 /app/output,按顺序尝试后端(cairosvg → Edge 无头浏览器 → Chrome 无头浏览器 → 内置 PIL 栅格化器用于 PNG)并记录每次后端失败。报告包含每个产物的检查项(分辨率、白色背景、PDF 头部/页面宽高比、矢量内容流)。将 figure.svg 和 model.json 复制到 /app/output 作为可编辑源文件,PNG 则作为渲染预览。

步骤 7 — 最终确定 result.json(如实填写契约覆盖范围)

填写每个 output_contract 字段 —— 无法填写的字段保留为 null,并在 partial_reasons 中说明原因。典型的映射(根据案例的契约调整名称):

  • editable_source → {svg, model, note: "分层 SVG; 每个元素都携带 data-evidence-*"}
  • exported_artifacts → 导出报告的产物(路径、格式、DPI、后端、检查项结果)
  • rendered_preview → PNG 路径
  • entity_relation_table → 实体和关系,包括引用/定位信息(或指向 model.json 的路径及其计数)
  • verification_report → verify.json 摘要(通过/失败计数、警告)
  • sources → 使用的源文档/DOI,附带引用出处
  • status → 仅当验证通过且所有导出正常时才为 complete;否则为 partial 并说明原因。uncertainty 列出歧义项(实体识别、未知方向、未解决的冲突)。

编辑现有的 SVG(保留源文件)

当案例提供要修改的 SVG 而不是要绘制的材料时:

  1. 读取 SVG;定位 node-*/edge-* 组及其 data-* 属性(此技能生成的图形完全是自描述的)。
  2. 局部更改(重新标记、重新着色、边类型/标签、标题、删除一个未连接的元素)→ 编写一个编辑 JSON 并运行 python scripts/edit_svg.py figure.svg edits.json -o figure_edited.svg。每个操作都需要一个 reason;报告会证明未触及的元素是逐字节相同的(preserved.ok)。然后重新导出(步骤 6)。
  3. 结构性更改(添加/删除实体或关系、反转方向)→ 这些会被 edit_svg 刻意拒绝(反转属性而不重新布线会导致画出错误的箭头)。从 SVG 的数据属性重建/扩展 model.json,编辑模型,重新渲染,重新验证。
  4. 如果现有的 SVG 来自其他工具(没有 data 属性),则从源材料重建模型并重新渲染 —— 不要手动修改外来的 SVG;在 result.json 的 change_log 中记录你所做的事情。

故障应对手册(真实路径,非伪代码)

情况检测时机行动result.json
案例/材料不可读步骤 1 或你自己的读取过程写入框架,partial_reasons 指明文件/问题status partial,字段为 null
无法引用某个关系model_check 错误 relation_no_evidence删除该关系或找到引用;绝不绘制未引用的关系图中不存在(正确)
未明确的方向你的提取过程direction: "unknown"虚线 + ?;uncertainty 条目
同义词/缩写实体你的提取过程单个实体,注明等价关系uncertainty 条目
矛盾的材料两个引用冲突绘制更强/更具体引用所支持的内容两个引用 + uncertainty 中的冲突
标签溢出其框verify 的 text_fit 警告缩短标签或添加 \n,重新渲染;框的增长是一个重新渲染决策携带警告
画布太小canvas_expanded 警告已自动加宽;或提高 canvas_width携带警告
cairosvg DLL 缺失(Windows)导出的后端尝试被记录自动回退到浏览器无头模式,然后是 PIL 栅格化器记录后端 + 尝试次数
无浏览器,无 cairosvg所有后端失败PIL 栅格化器(框/线/文本;标记被近似处理)+ notesPNG 质量导致 status partial,PDF 为 null 并说明原因
PDF 宽高比错误导出检查通过 @page 大小设置修复;如果后端忽略,记录为 checks_failstatus partial
验证无法通过verify_svg 退出码 1模型级别修复循环;如果不可能,则交付引用支持的部分verification_report 如实显示失败项

完成前的自我检查

  • verify_svg 退出码 0(或如实报告失败项);
  • /app/output 包含:result.json(所有契约键都存在,null 有解释)、figure.svg、model.json、PNG(300 dpi)、PDF;
  • 每个绘制的关系都是可引用的 —— 抽查三个随机的 data-evidence-quote 值,对照材料进行验证;
  • SVG 中出现的任何实体/数字都不在 model.json 之外;
  • change_log 说明了你所做的事情的来龙去脉,包括本技能的步骤。

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

biopathway-mechanism-diagram

Build or edit publication-grade biological mechanism/pathway diagrams from research materials (PDF/text) as a challengeable mechanism statement - three-layer model (typed entities, typed directed edges with verbatim evidence, compartment layout), semantics-correct SVG source, PNG/PDF exports and a traceable, uncertainty-aware result.json. Use for tasks asking to draw, generate or edit signaling pathways, mechanism figures, crosstalk diagrams or pathway flowcharts; refuses to guess regulation direction and marks unstated information instead.

graphical-abstract-builder

Build a single-page graphical abstract (question, method, results, conclusion) from research material as a traceable, editable SVG with PNG/PDF exports. Use when asked to create or edit a graphical abstract, science summary figure, mechanism or flow diagram, or data chart from a paper, study notes or experimental records, especially when editable source files and element-to-source traceability are required.

paper-to-academic-ppt

Turn a research paper (PDF) into a structured, evidence-traceable, template-compliant academic slide deck. Two phases: agent-authored narrative spine and page-level claims (each with paper locators and verbatim quotes), then scripted template adaptation that writes content into real master/layout placeholders, embeds original paper figures, checks overflow/aspect/notes, and exports a PDF preview. Handles missing conclusions, figure-trimming, layout mismatch and over-limit slide counts with explicit rules.

slides-genedit

Generate and edit academic presentation decks from research material. Two routes: (1) generate a new deck from a paper/notes under fixed audience, duration and slide-count constraints, with per-slide claims, verbatim-number evidence mapping, speaker notes, and a rendered PDF preview; (2) source-preserving edits of an existing starting deck - inventory it, apply only the requested local changes, and prove untouched slides stayed byte-identical. Use when asked to turn research material into slides, or to modify/compress/re-audience an existing deck without breaking it.

相关技能