Community画像github.com

schemdraw — ソース追跡可能な編集可能な科学図表生成

材料からエンティティと有向関係を抽出し、階層化SVGとして描画し、凡例をソースデータにマッピングし、ジャーナル解像度でPDF+PNGをエクスポートし、すべての要素がソースに遡れることを検証する、編集可能でソース追跡可能な科学図表・模式図生成ツール。

schemdraw — ソース追跡可能な編集可能な科学図表生成 とは?

schemdrawは、科学論文や資料からエンティティ(遺伝子名、濃度、時間点など)とその有向関係(活性化、抑制、結合、含有など)を抽出し、編集可能なSVG図を作成するAIエージェント用スキルです。図は階層化されており、テキストは選択可能で、矢印の色や線種で関係タイプを表現します。対応プラットフォームはClaude Code、Cursor、CodexなどのAIエージェント環境。入力は`/input/case.json`(科学資料、エンティティリスト、チャートデータ、エクスポート仕様を含むJSON)で、出力は`/app/output`以下にSVG、PDF(ベクター、選択可能テキスト)、PNG(指定DPI)、エンティティJSON、エクスポートレポート、検証レポートを生成します。主なプロセスは4フェーズ: (1) エンティティ/関係の抽出と図の描画、(2) LibreOffice経由のPDFエクスポート、(3) トレーサビリティとエクスポート契約の検証、(4) 成果物の出力ディレクトリへのコピー。検証では、すべての関係エンドポイントが宣言されたエンティティであること、すべての関係にソース引用があること、凡例がデータと一致すること、SVGに選択可能テキストがあること、PDF/PNGが適切に生成されていることをチェックし、失敗は明確に報告されます。エラー処理も充実しており、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に質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

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"> はエンティティごとに1つのグループと <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 → PNG を要求された DPI でラスタライズ。export_report.json を書き込みます。LibreOffice がない場合、レポートにその旨が記され、ステータスは partial になります — サイレント失敗は決してありません。

フェーズ 3 — 検証

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

チェック項目:

  1. すべての関係エンドポイントは宣言されたエンティティである(宙に浮いた矢印がない);
  2. すべての関係は provenance またはソース引用を持つ;
  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。
LibreOffice がないPDF/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 が必要です。モデルは決定論的抽出器が見逃したエンティティ/関係を、常にソースを添えて補完する必要があります。

関連スキル