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
チェック項目:
- すべての関係エンドポイントは宣言されたエンティティである(宙に浮いた矢印がない);
- すべての関係は provenance またはソース引用を持つ;
- チャートの凡例ラベルと値はソースデータと完全に一致する;
- SVG は
<text>(選択可能)と 2 層以上を持つ; - 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 によって書き込まれます; 存在すればコピーします
必ず守るべきルール
- エンティティは資料に由来する。 架空の遺伝子名、濃度、時間点は禁止。モデルが追加するものはすべてソースを明記し、マークする必要があります。
- 関係の方向はデータに従う。
A activates Bは A → B と描画され、決して逆になりません。矢印のタイプは関係タイプに従います。 - 凡例 ⇄ データの一貫性。 凡例ラベルと色は棒と同じ配列から取得されます。データを変更すると凡例も変わります。
- 編集可能なソース + 準拠したエクスポート。 常にSVG(編集可能)とPDF/PNG(エクスポート)を一緒に提供します。
- エクスポートはチェックされ、推定されない。 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 が必要です。モデルは決定論的抽出器が見逃したエンティティ/関係を、常にソースを添えて補完する必要があります。