関係スキーマ図作成:抽出 → モデル化 → レンダリング → 検証 → エクスポート
あなたは、科学的正確性がLLMレビュアーによってソース資料に照らして判断される図を作成しています。一般的な画像生成の主要な失敗モードは、まさにこのスキルが拒否する動作です。すなわち、抑制を活性化として描画する、上流/下流を逆転させる、包含を横並びのボックスで描画する、遺伝子名や数値を捏造する、主張のトレーサビリティが取れない、といったものです。ここにあるすべてのメカニズムは、そのような失敗を黙って出荷することを不可能にするために存在します。
非交渉事項
- 関係テーブルにないものは描画されません。 図のモデル(
model.json)が唯一の真実の情報源です。SVGはそこから生成され、それとの照合で読み戻されます。 - すべてのエンティティと関係には、ソース資料からの逐語的な引用 + 位置情報が付与されます。 引用がない関係はツールによって拒否されます(
relation_no_evidence)。引用できないものは描画してはいけません。 from/toは文の内容をエンコードし、レイアウトはエンコードしません。 「AはBを抑制する」⇒from: A, to: B, type: inhibits。レンダラーがジオメトリを決定し、検証ツールが矢印の先端が本当にBに当たっているかをチェックします。- 不明なものは不明として描画されます。 資料が方向を明示していない場合は、
direction: "unknown"を使用します。これは破線と?でレンダリングされ、result.json にフラグが立てられます。図をきれいにするために推測してはいけません。 - まず最低限の result.json を納品し、後で改善します。 ステップ1では、抽出前に明示的なnullを含む契約形状のスキャフォールドを作成するため、クラッシュが発生しても有効な部分的な成果物が残ります。
スクリプトは 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
ケースを読み込み、ディレクトリを作成し、すべての output_contract フィールドが null で存在し、status: "partial"、および partial_reasons エントリが含まれる /app/output/result.json を書き込みます。ケースファイルが存在しないか読み取り不可能な場合でも、スキャフォールドを書き込み、問題を記録します。また、自分で task.md とすべてのマテリアルファイルを読んでください。ラベルやファイル名から内容を推測しないでください。
ステップ 2 — エンティティ-関係テーブルを抽出する(あなたの判断に基づく。スクリプトではない)
実際のマテリアル(プラットフォームツールを介したPDFテキスト、テーブル、ケーステキスト)を読み、references/model-schema.md に従って /app/work/model.json を構築します。
- 1つの科学的作用主体につき1つのエンティティ。
label= ソースに印刷されている通りの正式名。type= 小さなサブタイトルとして表示される機能的役割。 - 記述された相互作用ごとに1つの関係。
typeはシンボルライブラリから(activates inhibits binds modifies transports indirect precedes contains parallels)、directionは(A_to_B/B_to_A/bidirectional/unknown)。 - 包含関係(「X複合体はA、B、Cから構成される」)は、メンバーを持つグループと、
contains関係になります。エッジではありません。並置でもありません。 - 時間的/プロセス的順序(「最初に…次に…」)は、ステップラベル付きの
precedesになります。 evidence= マテリアルからの逐語的な部分文字列 + 位置情報(セクション、段落、テーブル行、ページ)+ ソースID(DOI/ファイル名)。
困難なケースの抽出ルール:
- エンティティのあいまいさ(同義語/略語、「β-カテニン」対「CTNNB1」):1つのエンティティとし、ラベルはソースに印刷されている通りにし、result.json の
uncertaintyに同等性を記録します。ソースが区別している2つの名前は、2つのエンティティとして残します。 - 方向が明示されていない場合:
direction: "unknown"(破線 +?)。あいまいさをuncertaintyに記述します。もっともらしさで解決しないでください。 - 間接的な証拠(X→Yの主張に対して「XはZを介してYにつながる」):タイプ
indirect(破線)を使用するか、各ホップが引用されている場合はメカニズムチェーン X→Z→Y をモデル化します。チェーンを優先してください。レビュアーはそれを追跡できます。 - マテリアル内の数値/単位/濃度(例:「3.3–10.4%」):エッジ/ノードラベルに正確に印刷されている通りに保持し、丸めたり捏造したりしないでください。
- ケースが実際のデータ値のチャートを要求する場合、それはこのスキルの中核(統計的チャート作成)の範囲外です。該当するもの(エンティティテーブル、データから凡例へのマッピングの規律)は納品し、残りは理由とともに partial としてマークします。
ステップ 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にパッチを当てないでください。2回の反復は正常です。チェックが合格できない理由が資料の矛盾である場合、引用がサポートする図を保持し、矛盾を 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を提供する場合:
- SVGを読み込みます。
node-*/edge-*グループとそのdata-*属性を見つけます(このスキルからの図は完全に自己記述的です)。 - ローカルな変更(ラベルの変更、色変更、エッジタイプ/ラベルの変更、タイトル、未接続要素の削除)→ 編集JSONを書き込み、
python scripts/edit_svg.py figure.svg edits.json -o figure_edited.svgを実行します。すべての操作にはreasonが必要です。レポートは、変更されていない要素がバイト単位で同一であることを証明します(preserved.ok)。その後、再エクスポートします(ステップ6)。 - 構造的な変更(エンティティまたは関係の追加/削除、方向の反転)→ これらは設計上 edit_svg によって拒否されます(再ルーティングなしで属性を反転すると、嘘の矢印が描画されます)。SVGのデータ属性から model.json を再構築/拡張し、モデルを編集し、再レンダリング、再検証します。
- 既存のSVGが別のツールからのものである場合(データ属性なし)、ソースマテリアルからモデルを再構築し、再レンダリングします。外部SVGを手動でハックしないでください。result.json の
change_logに行ったことを記録します。
障害対応プレイブック(散文ではなく実際のパス)
| 状況 | 検出 | アクション | result.json |
|---|---|---|---|
| ケース/マテリアルが読み取り不可能 | ステップ1または自分自身の読み取り | スキャフォールド作成、partial_reasons にファイル/問題を記載 | status partial、フィールド null |
| 引用できない関係 | model_check エラー relation_no_evidence | 関係を削除するか引用を見つける。引用なしでは決して描画しない | 図から欠落(正しい) |
| 方向が明示されていない | あなたの抽出 | direction: "unknown" | 破線 + ?; uncertainty エントリ |
| 同義語/略語エンティティ | あなたの抽出 | 単一エンティティ、同等性を記録 | uncertainty エントリ |
| 矛盾するマテリアル | 2つの引用が衝突 | より強力/より具体的な引用がサポートするものを描画 | 両方の引用 + 矛盾を uncertainty に |
| ラベルがボックスからはみ出す | verify text_fit 警告 | ラベルを短縮するか \n を追加して再レンダリング。ボックス成長は再レンダリングの判断 | 警告を引き継ぎ |
| キャンバスが小さすぎる | canvas_expanded 警告 | すでに自動拡大済み。または canvas_width を引き上げる | 警告を引き継ぎ |
| cairosvg DLLが見つからない(Windows) | エクスポートバックエンド試行を記録 | 自動的にブラウザヘッドレスにフォールバック、次にPILラスタライザ | バックエンド + 試行を記録 |
| ブラウザなし、cairosvgなし | すべてのバックエンドが失敗 | PILラスタライザ(ボックス/線/テキスト。マーカーは近似) + notes | PNG品質は status partial、PDFは null と理由 |
| PDFアスペクトが間違っている | エクスポートチェック | @page サイズ指定で修正。バックエンドが無視する場合、checks_fail として記録 | status partial |
| verify が合格できない | verify_svg 終了コード 1 | モデルレベルの修正ループ。不可能な場合は、引用されたサブセットを出荷 | verification_report に不合格を正直に表示 |
完了前の自己チェック
verify_svg終了コード 0(または不合格が正直に報告されている)/app/outputに以下が含まれる:result.json(すべての契約キーが存在し、nullは説明済み)、figure.svg、model.json、PNG(300 dpi)、PDF- 描画されたすべての関係は引用可能である — ランダムに3つの
data-evidence-quote値をマテリアルとスポットチェックする - SVG内に model.json にないエンティティ/数値は存在しない
- change_log があなたが行ったことのストーリーを伝えている。このスキルのステップも含む