Community影像github.com

schemdraw — 可編輯的科學示意圖,具備來源可追溯性

生成可編輯、來源可追溯的科學示意圖與圖表:從素材中提取實體與有向關係,繪製成帶有可選取文字的分層 SVG,將圖例/顏色對應至原始資料,輸出符合期刊解析度的 PDF 與 PNG,並驗證每個元素皆可回溯至來源。

schemdraw — 可編輯的科學示意圖,具備來源可追溯性 是什麼?

這個技能專為需要生成科學示意圖、機制圖或流程圖的 AI 代理或開發者設計,目標是產出「正確、可編輯且符合發表規範」的圖形。它會從輸入的科學素材(例如文字或 Markdown)中,利用預定義的語法模式(如「X 激活 Y」、「X 抑制 Y」、「X → Y」)自動提取實體與有向關係,並將它們繪製成分層的 SVG 檔案,其中箭頭顏色與線條樣式對應關係類型(綠色 = 激活,紅色 = 抑制,虛線 = 包含)。此外,若素材包含圖表資料,它會生成獨立且圖例與資料一致的長條圖 SVG。整個流程包含三個主要階段:提取與繪圖、匯出(透過 LibreOffice 轉換為向量 PDF,再用 PyMuPDF 以指定 DPI 產生 PNG),以及驗證(確保每個關係端點皆為已宣告的實體、圖例與原始資料完全匹配、SVG 具有可選取文字且至少有兩層結構)。此技能支援 Claude Code 等平台,並透過命令列腳本整合,遵循嚴格的規則:實體與關係必須源自素材,方向由資料決定,圖例與資料一致,且一律同時提供可編輯的 SVG 與符合解析度的匯出版本。當輸入為空、缺少關係或缺少 LibreOffice 時,該技能有明確的例外處理方式,確保不會靜默失敗。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/iakRulan/schemdraw/tree/HEAD

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

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

schemdraw — 可編輯的科學示意圖,具備來源可追溯性 是做什麼的?

腳本路徑:本技能安裝於 /skills/weekly-skill/,腳本絕對路徑為 /skills/weekly-skill/scripts/(工作目錄是 /app/work,不要使用相對路徑)。

產出一張正確、可編輯且符合匯出規範的圖形:每個實體/關係都可追溯至素材,圖例與資料一致,文字保持可選取,且匯出版本達到目標解析度。此技能存在的目的是為了防止以下失敗模式:圖片美觀但實體關係錯誤、基因名稱或濃度為虛構、圖例與資料不符,以及輸出僅為點陣圖而無法編輯。

一句話總結方法: 從素材中提取實體/關係 → 將它們佈局成分層 SVG(分組、可選取文字、箭頭方向依關係類型而定)→ 從相同來源資料建立圖表,並附上明確的圖例/顏色對應 → 匯出 PDF+PNG → 驗證可追溯性與匯出合約。

使用時機

  • 輸入:一個案例檔案(預設為 /input/case.json),內含科學素材、可選的實體/關係列表、圖表資料與匯出規格。
  • 輸出:在 /app/output 下 — figure.svg、chart.svg、figure.pdf、figure.png、entities.json、export_report.json、validation.json、result.json。
  • SVG 為可編輯的原始檔;PDF/PNG 為匯出版本。

流程(請依序執行)

階段 1 — 提取與繪圖

python3 /skills/weekly-skill/scripts/schem.py --case /input/case.json --work /app/work
  • 讀取每個素材(文字/Markdown),合併提供的 entities/relations 與從模式中提取的關係:X activates|promotes|enhances Y、X inhibits|suppresses|blocks Y、X -> Y、X --| Y、X binds|interacts with Y、X contains|includes Y。
  • 每個關係都帶有 provenance(text-pattern 加上來源引用)或來自提供的列表。
  • 寫入 entities.json 與分層的 figure.svg:<g id="arrows"> 帶有 data-source/data-target/data-type,<g id="nodes"> 每個實體一個群組並包含 <text> 標籤。箭頭顏色/線條樣式編碼關係類型(綠色 = 激活,紅色 = 抑制,虛線 = 包含)。
  • 若案例中有圖表資料,寫入 chart.svg,其長條帶有 data-label/data-value,圖例使用與長條相同的調色盤索引。

階段 2 — 匯出

python3 /skills/weekly-skill/scripts/export.py --work /app/work --dpi 300

LibreOffice 以無頭模式將 SVG 轉換為 PDF(向量、可選取文字);PyMuPDF 將 PDF 以要求的 DPI 點陣化為 PNG。寫入 export_report.json。若 LibreOffice 缺失,報告中會說明,且狀態變為 partial — 絕不會靜默失敗。

階段 3 — 驗證

python3 /skills/weekly-skill/scripts/validate.py --case /input/case.json --work /app/work

檢查:

  1. 每個關係的端點都是已宣告的實體(無懸空的箭頭);
  2. 每個關係都有出處或來源引用;
  3. 圖例標籤與值與來源資料完全匹配;
  4. SVG 有 <text>(可選取)且至少有 2 層;
  5. PDF 與 PNG 匯出存在,且 PNG 檔案大小不異常地小。

階段 4 — 複製交付物

mkdir -p /app/output
cp /app/work/figure.svg /app/work/chart.svg /app/work/figure.pdf /app/work/figure.png \
   /app/work/entities.json /app/work/export_report.json /app/work/result.json /app/output/
# validation.json 由 validate.py 寫入;若存在也一併複製

必須遵守的規則

  1. 實體來自素材。 不得虛構基因名稱、濃度或時間點;模型添加的任何內容都必須有來源並標記。
  2. 關係方向由資料決定。 A activates B 繪製為 A → B,不可反向;箭頭類型依關係類型而定。
  3. 圖例 ⇄ 資料一致性。 圖例標籤與顏色來自與長條相同的陣列;更改資料會改變圖例。
  4. 可編輯來源 + 符合規範的匯出。 始終同時提供 SVG(可編輯)與 PDF/PNG(匯出)。
  5. 匯出需經檢查,非預設成立。 DPI、字型嵌入與檔案存在與否皆記錄;匯出失敗會回報。

例外處理

情況行為
無素材 / 空白實體列表為空;仍會寫入帶有標題的 SVG
關係端點未知保留在 entities 中(從模式添加)並繪製
缺少圖表資料跳過 chart.svg;entities.json.chart_svg = null
缺少 LibreOfficePDF/PNG 缺失,export_report.status = partial,記錄限制
無關係僅有節點的 SVG;驗證會記錄 0 個關係

自我檢查

python3 /skills/weekly-skill/scripts/validate.py --case /input/case.json --work /app/work
python3 -c "import json;e=json.load(open('/app/work/entities.json'));print(len(e['entities']), len(e['relations']), e['relation_counts'])"

必須為 valid: true;模型必須補足確定性提取器遺漏的任何實體/關係,且始終帶有來源。

相關技能