生物パスウェイ・メカニズム図作成 は何をしますか?
パスウェイ図は、読者が一矢ごとに挑戦できるメカニズム記述です。このスキルの契約:キャンバス上のすべてのエンティティとすべてのエッジは、位置情報付きの逐語引用にトレース可能でなければなりません。相互作用セマンティクス(活性化/阻害/結合/修飾/輸送)は視覚的に区別され、決して混同されません。ソースが明示していないもの(方向、位置、数値)は、推測ではなく「未記載」として可視的にマークされます。成果物は、層状でIDアドレス可能な編集可能SVGに加え、PNG/PDFエクスポート、および契約を完全に満たすresult.jsonです。
使用する場合 / 使用しない場合
使用する場合:メカニズム図、シグナル伝達経路図、受容体から核へのカスケード、経路クロストーク、「この論文の図Nを描いて」というタスク、および既存のパスウェイ図への編集(エンティティまたはエッジの追加/削除、ラベルの変更)。 使用しない場合:統計チャート(棒/箱/火山図)、実験スキーマ、または美的目的のみのレタッチ。これらは隣接するスキルに属します。
実行契約(プラットフォームランタイム)
- 入力:
/input/case.json(+ task.md)。/app/work下で作業し、成果物は/app/output下に配置。 - 実行全体の最初のアクション(ケースを詳細に読む前):
python scripts/scaffold_result.py --input /input/case.json --outdir /app/outputこれにより、すべての出力契約フィールドが存在し、未生成のものはnull+理由が設定されたresult.jsonが書き込まれます。それを段階的に更新し続けます。契約フィールドを決して削除しないでください。 - 以下のすべてのスクリプトは、
--model/--svgスタイルのパスを引数に取り、特に明記がない限り純粋なPython 3(stdlibのみ)です。references/はスクリプトによって読み込まれます。ステップ1の前に自分で.mdファイルを読んでください。
ステップ0 - 契約を読み、スキャフォールドを実行(1リクエスト)
スキャフォールドを実行します。task.md + case.json をざっと読み、図のターゲット(どのメカニズムか、再現する場合はどの図か、生成か編集かのシナリオ)、必要なエクスポート形式、およびエビデンスの範囲を特定します。記入する必要のある契約フィールドリストを記録します。予算意識:5〜8モデルステップで完了を目指します。スクリプトが重い処理を行い、あなたは科学的判断を行います。
ステップ1 - メカニズムモデルの抽出(科学的コア - 自分で実施)
実際の資料を読みます(PDFを実際に解析します。ファイルを読み、ラベルから内容を推測しないでください)。references/layout-conventions.md に従って /app/work/model.json を自身の判断で構築します:
- エンティティ — 遺伝子 / タンパク質 / 受容体 / RNA / 複合体 / 分子 / 細胞 / ファミリー。
references/naming-rules.mdを適用します:遺伝子記号はイタリック体で、遺伝子ノードはそのタンパク質と区別します(MYC vs MYC)。同義語にソースのスペルを含めた推奨記号を使用します。ファミリーとメンバーを区別します。明示された複合体ごとに1つのノードを作成します。各エンティティはsource: {loc, quote}を持ちます — これは逐語引用と、再発見に十分な精度の位置(セクション/段落/ページ/図キャプション)です。 - エッジ —
references/edge-types.jsonの閉じたセットからの型(活性化、阻害、結合、リン酸化、ユビキチン化、転写制御、移行、複合体形成、...)。directedは明示的に設定する必要があります。方向を決して推測しないでください:引用に方向の手がかりがない場合は、directed: falseを設定し、不確実性を記録します(references/uncertainty-policy.md)。結合/リクルートメントは無向です。転写制御は遺伝子ノードをターゲットとし、符号が必要です。 - 区画 — 細胞外 / 膜 / 細胞質 / 核(+ 小胞体、ゴルジ体、オルガネラのサブ領域(メカニズムに必要な場合))。位置が明示されていないエンティティは、
unspecifiedバンドに配置します — 決して暗黙的に細胞質に入れないでください。受容体は膜バンドに固定します。 - 順序 — パスウェイの位置に基づいて
orderを設定します(トポロジカル順序であり、テキスト順序ではありません)。フィードバックループは逆向きエッジとして自然に現れます。 - キャンバス上の数値(発現量、有意性)は、ソースに逐語的に存在する場合のみ設定します。それ以外の場合は、データマッピングを明示的にnullのままにします。
実践的な抽出順序:最初のパスで全体的な流れを読みます。2回目のパスで文ごとにエンティティと引用を抽出します。3回目のパスで阻害剤、フィードバック、クロストークを含むエッジを抽出します(これらは「しかしながら/一方」の文に隠れています)。
ステップ2 - モデルの検証(スクリプト)
python scripts/validate_model.py --model /app/work/model.json \
--report /app/work/validation-report.json
すべての E-* エラーを修正します。E-DIR-01(方向の手がかりのない有向エッジ)は中核的な科学的ガードです:方向を明示する文を引用するか、無向+不確実性にダウングレードします。警告については意識的な判断が必要です:ファミリーノード、受容体の配置、符号と引用の不一致。有効になるまで再実行します。資料が必要な契約項目をサポートできない場合は、今のうちにそれを記録します(ステップ5でnull+理由になります)。
ステップ3 - SVGのレンダリングとエクスポート(スクリプト)
python scripts/render_svg.py --model /app/work/model.json \
--out /app/output/pathway.svg --report /app/work/render-report.json
python scripts/export_assets.py --svg /app/output/pathway.svg \
--outdir /app/output --model /app/work/model.json \
--png-width 2400 --report /app/work/export-report.json
レンダリングレポートの警告(キャンバス制限、不明な区画)を読みます。自分でPNGを確認します。レイアウトがメカニズムを不明瞭にしている場合(エッジの交差が分岐を隠している、フィードバックがカスケードにかぶっているなど)、モデルの order/ピン位置を調整して再レンダリングします。SVGは決定論的です:同一のモデル → 同一のSVG。
ステップ4 - 編集シナリオ(ケースが既存図の編集を要求する場合)
まずターゲット図のモデルを再構築し(元の図のソーステキストに対してステップ1を実行)、次にソースを保存する編集を使用します — 元のモデル/SVGはバックアップされ、すべての編集はモデルの change_log に記録されます:
python scripts/apply_edit.py --model /app/work/model.json --op add-edge \
--id e-new --src A --tgt B --type inhibition --directed true \
--sign negative --loc "..." --quote "..."
操作:エンティティの追加/名前変更/削除(削除は、エッジが接続されている場合は --cascade がないと拒否され、カスケード削除は不確実性として記録されます)、エッジの追加/削除、区画の追加。追加されたすべてのエンティティ/エッジには、逐語的な --loc + --quote が必須です。編集後、再検証(自動)および再レンダリング(ステップ3)を行います。
ステップ5 - 検証とresult.jsonの最終化(スクリプト+自分)
python scripts/verify_outputs.py --model /app/work/model.json \
--svg /app/output/pathway.svg --result /app/output/result.json \
--exports /app/output/pathway.png /app/output/pathway.pdf \
--report /app/output/verification-report.json
これにより、SVGが再読み込みされ、ノード/エッジの読み戻し、凡例↔使用法の両方向での一貫性、ラベルオーバーフロー、キャンバス制限、エクスポートの存在、およびresult.json内のすべてのnullに理由があることがチェックされます。次に、自分でresult.jsonを最終化します:契約フィールドを埋めます(編集可能ソースパス、バックエンド/パラメータ付きエクスポート、引用付きエンティティテーブル/エッジテーブル、凡例ベース、バージョン付きソース、不確実性、検証サマリー、誠実なステータス)。nullのものについては _unanswered_reasons を保持します。部分的な納品は、その限界を平易な言葉で明記する必要があります。
例外処理(実際のパス、装飾ではありません)
| 障害 | 検出 | アクション |
|---|---|---|
| PDFが読めない/テキストレイヤーがない | 解析失敗または空テキスト | レンダリング用にpdf-render-tool/ocr-toolを使用、result.jsonに「テキストレイヤーなし」フラグを設定 |
| エンティティ名が曖昧(2つの読み方) | あなたの抽出 | 文脈に応じて選択、代替案と不確実性を記録。決定不能な場合はnull+理由 |
| 方向が明示されていない | E-DIR-01 | 無向エッジ(矢印なし)+不確実性にダウングレード。絶対に推測しない |
| 区画が不明 | E-CMP-01 / レイアウト警告 | unspecified バンド+注記 |
| データエンコードされたビジュアルに数値データがない | モデルに逐語的数値がない | トポロジを描画、マッピングをnull+「ソースにデータなし」とマーク |
| ラベルオーバーフロー | verify label_overflow | ラベルを短縮/ラベル+サブに分割/並べ替え |
| キャンバスが制限を超える | レンダリング警告 | パネルに分割するかブランチを削減、注記 |
| エクスポートバックエンドがない | エクスポートレポートステータス失敗 | フォールバックチェーンは既に試行済み。SVGを納品、失敗とガイダンスをresult.jsonに記録 |
| 空白/退化したPNG | blank_check | レンダリングレポートを調査、再レンダリング、記録 |
| 検証エラーが続く | 終了コード2 | モデルを修正。資料から修正不可能な場合は、有効なサブセット+明示的な制限を納品 |
品質基準(完了前の自己チェック)
- レビュアーは任意の矢印を指して、埋め込みテーブル/モデルからその逐語的な正当性を取得できますか?(トレーサビリティ)
- 活性化/阻害/結合/修飾は視覚的に区別されており、凡例は描かれたものと一致していますか?欠落やゴーストエントリはありませんか?
- 明示されていないすべてのものは、可視的に明示されていませんか?(無向、unspecified バンド、null+理由)
- SVGを開いて1つのラベルを変更し、再エクスポートできますか?(層状、IDアドレス可能、標準フォントスタック)
- result.jsonは、誠実なステータスですべての契約フィールドをカバーしていますか?
ファイル
scripts/scaffold_result.py- null+理由付きの契約完全なresult.jsonscripts/validate_model.py- スキーマ+方向エビデンス+命名チェックscripts/render_svg.py- model.jsonから決定論的層状SVGを生成scripts/export_assets.py- フォールバックチェーン+空白チェック付きPNG/PDFscripts/apply_edit.py- ソース保存、記録付き編集scripts/verify_outputs.py- バンドルの読み戻し検証references/edge-types.json- 機械可読な記号セマンティクスreferences/symbol-semantics.md- 視覚文法とその根拠references/naming-rules.md- 遺伝子/タンパク質/ファミリー/複合体の命名規則references/uncertainty-policy.md- ダウングレードルール;決して推測しないポリシーreferences/layout-conventions.md- model.jsonスキーマ+レイアウトアルゴリズムexamples/ras-mapk-case/- 実際の資料を使った実施例(Brown & Ried 2022)README.md- スタンドアロン使用ドキュメント