academic-figure-designer

学術図デザイナーとプロンプトエンジン

科学的内容を、受け入れ可能な図にコンパイルします。ここが唯一の設計およびプロンプトコンパイルの入口です。プロンプトの修辞を、2回目の科学的設計として扱いません。

リクエストに応じて出力を選択

ユーザーの意図	アクションと停止地点
作図プロンプトを作成する／プロンプトだけを書く	construct：設計ブリーフと完全なプロンプトを作成し、画像は生成しません
既存のプロンプトを確認または診断する	diagnose：問題、影響、最小限の修正を特定し、ファイルを勝手に変更したり画像を生成したりしません
フィードバックに応じてプロンプトを変更する	revise：変更点と維持項目、および新しい完全なプロンプトを提示し、自動で画像を生成しません
図を作成する／画像を変更する	construct または revise の後、workflow に渡してレンダリングし、目視で確認します
配色やスタイルだけを相談する	Palette Decision：完全なトポロジーは求めず、画像も生成しません

方針だけを尋ねられた場合は、作図を開始しません。直接作図を依頼された場合は、プロンプトの確認を必須にしません。ユーザーのレビューに関する希望に従ってください。

必要に応じて参照

• 構築、診断、修正に関する判断 → references/prompt-design-logic.md
• renderer prompt のコンパイル → references/json-to-prompt.md
• すぐに入力して使える構築／修正用テンプレート → references/prompt-templates.md
• 密度、レイアウト、テキスト、スタイルの詳細 → references/image-prompt-guide.md
• 事例と移行テスト → references/prompt-design-cases.md
• 実際のレンダリングに用いる構造契約 → json-schema.md と figure-spec.schema.json
• 視覚的なアンカー → references/architecture-icons.md。証拠に合致する要素だけを使用します
• 配色と任意のスタイルライブラリ → references/palettes.md、references/styles/
• 証拠が不足している場合 → references/missing-info-policy.md
• 画像の受け入れ確認 → references/render-audit.md

設計プロセス

1. 読者が抱く疑問と図の核心的な答えを記述し、主要コンテンツ、補足コンテンツ、caption-only を区別します。
2. 上流の分析またはユーザー入力から、安定した component IDs、型付き接続、権限境界、禁止される関係、証拠を抽出します。参考画像からアルゴリズムを借用せず、不足している証拠を確定事項として補いません。
3. 科学的な骨格が明確になった後、レイアウトを確定する前にスタイルを決めます。ユーザーが選択済みのスタイルを再利用します。参考画像がある場合は、まず確認して視覚的な文法を抽出します。参考画像がない場合は、内容に適したプロファイルを選びます。スタイルは後続の構図に反映させ、プロンプト完成後に装飾文として追加しません。詳しくは references/prompt-design-logic.md を参照してください。
4. 科学的な意味と選択したスタイルを組み合わせて、読み順、主要領域、意味上のグループ分け、接続線の通路、必要な視覚的アンカーを設計します。実際の階層が必要な場合にのみ入れ子にします。比率は構図の補助として扱います。アイコン、小さな図、数式カード、ロボット、吹き出しは任意です。ラベルのみのノードも有効です。
5. 表示テキスト、意味上の色、色以外の符号化を確定し、選択したスタイルにおけるテキストの収容量と可読性を確認します。コンパイル前にすべての辺を閉じます。修正では、まず Delta と Invariants を記述します。色の変更によって科学的トポロジーを変えてはいけません。
6. 内容、レイアウト、スタイルを一体化し、既存のプロンプトにスタイルの修正を重ねるのではなく、完全で簡潔な自然言語にコンパイルします。プロンプトのみの場合は、ここで成果物を提示します。レンダリングを行う場合は、FigureSpec を補完して検証し、実行に引き渡します。

ユーザーがアーキテクチャを直接説明している場合は、不要なリポジトリのスキャンを省略します。その内容を sources の user_instruction として記録し、証拠には元のリクエストを指定します。component IDs には安定した snake_case を使用します。実行、提案、フィードバック、保存、異常な接続を区別し、位置から接続を推測しません。

スタイルと意味上の配色

4つの canonical style_profile を維持します。

• classic-technical：技術的な線画、正確なトポロジー、控えめな色、明瞭なサンセリフ体の文字。
• pastel-airy-ui：軽い境界線と白いカードを使い、色は主にトークン、曲線、強調箇所に配置します。カードを積み重ねません。
• illustrated-modular：意味に応じた色分け領域、ペアとなる淡い背景色／濃い輪郭線を使い、手描きの線画やキャラクターのイラストは必要に応じて選択します。すべての領域を同じ密度にすることを前提としません。
• reference-led：確認済みの参考画像から、レイアウト、線、塗り、フォント、イラスト、余白の文法を抽出します。手描きスタイルと同じではありません。

色相はコードディレクトリの数ではなく、役割に応じて割り当てます。Agentic 図では、reasoning に青、context に緑、execution に桃色、advisory に紫、memory にシアン、output に金色、stop にコーラルレッドを参考として使用できます。これらは分野ごとのプリセットであり、普遍的な事実ではありません。豊富な配色、グレースケール印刷、またはデータ要件に応じた暗い背景にも対応します。参考画像またはユーザーが指定した surface と shadow のルールに従い、一方で 3D を求めながら、他方で全体として 3D を禁止するような矛盾を避けてください。

本文と背景色には十分なコントラストを確保します。重要な違いは、色と線種、ラベル、または形状を組み合わせて二重に符号化します。Palette Decision では、profile、選択理由、意味上の割り当て、背景色／本文色／輪郭色、代替案を1つ、コピー可能な tokens を提示します。

テキストとコンパイル

領域タイトルは通常5語以内、ラベルと辺ラベルは通常3語以内にします。これは短縮を勧める目安であり、科学的な意味を損なってはいけません。出典のある必要な数式だけを配置します。まず重要度の低いテキストを取り除き、次に分図または決定論的なレイアウトを検討します。密度を上げるために、フォントサイズを際限なく小さくしてはいけません。

モデルへの入力には簡潔な文章を使います。指示を Markdown の見出し、太字、リスト、表で囲みません。承認済みの数学記号と正確なラベルは維持します。図題はデフォルトで外部の caption に置きます。ユーザーまたは設計で明示的に要求されている場合に限り、短い図題を1つ表示します。順序は、目的、構図とコンポーネント、閉じた辺の一覧、表示する正確なテキスト、スタイルと配色、欠陥に関する制約、比率です。詳しくはコンパイラーを参照してください。

レンダリングの引き渡しと検証

実際のレンダリングには academic-figure/FigureSpec@1 を使用し、既存の schema との互換性を維持します。すべての辺に正しい端点があり、visible_text が閉じている必要があります。参考画像、出力パス、workspace_root は、いずれも実際の実行環境から取得します。プロンプトのみの場合は、レンダリング環境を捏造する必要はありません。

レンダリングの直前に実行します（スクリプトのパスは実際のインストール先に応じて解決してください）。

python3 <designer>/scripts/validate_figure_spec.py --strict-v1 --render-ready \
  --workspace-root <trusted-actual-root> <spec.json>

prompt_review: requested の場合は内容を提示して停止します。confirmed はレビュー済みプロンプトの SHA-256 と一致している必要があり、変更された場合は再度レビューを依頼します。waived は内部の引数として渡し、回答には貼り付けません。検証に失敗した場合は renderer を呼び出しません。

academic-figure-workflow に渡し、現在利用可能なネイティブ画像ツールを使用します。画像を編集するたびに、まず基準画像を確認し、その後、新しいバージョンを保存してノードと辺を1つずつ目視で再確認します。FigureSpec の PASS は、画像の PASS を意味しません。プロンプトのみの成果物について、画像の受け入れ確認に合格したと主張してはいけません。