Prompt to Canvas
ユーザーが提供するコンテンツから、洗練された編集可能なExcalidrawキャンバスを作成するためのデザインシステムスキルです。 エージェントはレイアウトを構成し、バンドルされたスタイルカタログを視覚的な方向性として使用し、SVGソースを構築、編集可能なExcalidrawシーンJSONに変換し、ローカルエディタで開きます。
これは自動チャート生成ツールやテンプレートの穴埋めツールではありません。スタイルはパレットと雰囲気を提供します。エージェントはテーゼ、構造、グループ化、階層、ラベル、コネクタを決定します。
キャンバス上の表示テキスト、見出し、セクションラベル、注釈、キャプションには、ユーザーが明示的に別の言語を指定しない限り、ユーザーの主要な対話言語を使用してください。技術用語、製品名、API名、頭字語、コード識別子、メトリクス、引用ソースフレーズは、元の言語のままの方が明確な場合は翻訳しないでください。
使用するタイミング
- ユーザーが編集可能なキャンバス、インフォグラフィック、ダイアグラム、アーキテクチャ図、タイムライン、比較図、ダッシュボード、コンセプトマップ、プレゼンテーション用ビジュアルを求めている場合。
- ユーザーがコンテンツを提供し、「描いて」、「可視化して」、「これをキャンバスにして」、「ポートフォリオボードを作って」と依頼した場合、またはこのスキルを名前指定した場合。
- 結果が洗練されており、編集可能で、エクスポート可能で、視覚的にスタイリングされている必要がある場合。
ステップ0:前提条件
scripts/preflight.sh を実行するか、手動で確認してください:
- Node 20以上
assets/editor/index.htmlが存在すること。scripts/svg-to-scene.mjs、scripts/validate-scene.mjs、scripts/open-editor.mjsが存在すること。CATALOG.md、RULES.md、templates/、assets/styles/が存在すること。
不足しているものがあれば、ユーザーにその旨を伝えて停止してください。
会話の進め方
- キャンバスを理解する。 コンテンツ、目的、対象読者を特定します。それがボードを変えるほど不明瞭な場合は、構築前に短い質問を1つしてください。
- ホストが構造化された選択肢や選択可能なオプションをサポートしている場合は、それらを使用します。それ以外の場合は、コンパクトなテキストで質問します。
- 推測される2〜3のオプションを提供し、推奨オプションを最初に配置し、ユーザーのプロンプトに十分なコンテキストがある場合は、ユーザーの言語で「エージェントが選択」オプションを含めます。
- 雰囲気について尋ねる。 視覚スタイルについて尋ねます:落ち着いた、プロフェッショナル、遊び心のある、大胆な、ブランドライク、色の好み、ムード。ユーザーに好みがない場合は、選択を申し出ます。ユーザーがすでにスタイルや明確な雰囲気を指定している場合はスキップします。
- ホストがサポートしている場合は、選択可能なオプションを使用します。
- オプションをカタログレベル(Restrained、Balanced、Bold)にマッピングします。
- スタイルを選ぶ。
CATALOG.mdを使用して1つのスタイルを選択します。カタログテーブルのみから選択し、複数のdesign.mdファイルを比較しないでください。選択したスタイルとその理由を1行でユーザーに伝えます。 - 構築する。
RULES.md、rules/canvas-rules.md、rules/visualization-strategy.md、および選択したtemplates/<slug>/design.mdのみを読み、次の手順を実行します:rules/analysis-prompt.mdをプライベートな編集チェックリストとして使用します:対象読者、アーティファクトの役割、コアテーゼ、主要エンティティ、関係性、トレードオフ、キャンバスに配置する価値のある3〜6の主張を決定します。- キャンバス上の表示テキスト、見出し、セクションラベル、注釈、キャプションを、ユーザーが別の言語を指定しない限り、ユーザーの主要な対話言語に一致させます。技術用語、製品名、API名、頭字語、コード識別子、メトリクス、引用ソースフレーズは、元の言語のままの方が明確な場合は翻訳しないでください。
- まず、論理的な空間(約1600〜1700px幅)で
diagram.svgを作成します。ネイティブSVGシェイプ(rect、circle、ellipse、line、polyline、text)を使用します。すべての表示ラベルはテキストとして保持します。 - Excalidrawの無限キャンバスの背景は白のままにします。選択したスタイルに色付きの紙/背景がある場合は、それをシーン内の編集可能な長方形として描画します。その色を
appState.viewBackgroundColorに設定しないでください。 - スタイル選択をExcalidrawキャンバスの背景から独立させて維持します。コンテンツ、対象読者、形式、雰囲気に基づいて選択します。テンプレートの紙/背景色は、シーン内の編集可能な長方形としてビジュアルアーティファクトの一部のままにします。
- 完成したアーティファクトのコンテンツのみをキャンバスに配置します。プロンプト、ソース、ファイルパス、選択したスタイル、プロセスに関するコンテキストはチャット返信に属します。
- 選択したスタイルをビジュアルシステムとして適用します:パレット、密度、ストローク、コーナー処理、階層、アクセントの規律、レイアウトのムード。
- SVGを編集可能なExcalidrawシーンJSONに変換します:
node scripts/svg-to-scene.mjs --svg diagram.svg --out scene.json
- シーンを検証します:
node scripts/validate-scene.mjs --scene scene.json
明確な言語/スクリプトの期待がある場合は、それも検証します:
node scripts/validate-scene.mjs --scene scene.json --expected-language <language-code>
- 開かれたエディタまたはレンダリングされたエクスポートを検査します。テキストのクリッピング、窮屈な間隔、弱い階層、偶発的な重複、古いサンプルテキスト、スタイルの逸脱を修正します。
diagram.svgを修正して再変換することを優先し、シーンJSONの編集はExcalidraw固有のクリーンアップにのみ使用します。
- エディタを開く。 以下を使用します:
node scripts/open-editor.mjs --scene scene.json
各呼び出しは独立したローカルエディタURLを起動します。新しいキャンバス、代替テンプレート、再生成バージョンごとに、古いURLを再利用せずにこれを行います。デフォルトでは、スクリプトは新しい利用可能なポートに移動し、一意のキャッシュなしURLからシーンを提供します。ポートは、その open-editor.mjs プロセスが停止されるか、ホストセッションが終了したときに解放されます。
- 提供する。 印刷されたローカルURLをユーザーに渡します。エディタが中国語/英語のUI切り替え、更新しても安全なローカル自動保存、PNG/SVGエクスポートをサポートしていることを伝えます。同じコンテンツを別のスタイルで再レンダリングすることを提案します。
ファイル
CATALOG.md:雰囲気、形式、パレットシグネチャを持つ35のスタイル。RULES.md:スタイルシステムで共有されるSVGメディアルール。templates/<slug>/design.md:スタイルごとのパレットとムードガイド。assets/styles/:スタイルプレビュー画像。rules/analysis-prompt.md:プライベートなコンテンツ形成チェックリスト。rules/canvas-rules.md:Excalidrawシーンと検証ルール。rules/visualization-strategy.md:レイアウトとスタイル忠実度のガイダンス。scripts/preflight.sh:依存関係とリソースのチェック。scripts/svg-to-scene.mjs:SVGから編集可能なExcalidrawへのコンバーター。scripts/validate-scene.mjs:シーンスキーマバリデーター。scripts/open-editor.mjs:ローカルエディタサーバーとシーンローダー。デフォルトでは、個別の生成のために新しいポートを割り当てます。
スモークテスト
scripts/preflight.sh
node scripts/svg-to-scene.mjs --svg test-diagram.svg --out test-scene.json
node scripts/validate-scene.mjs --scene test-scene.json
node scripts/open-editor.mjs --scene test-scene.json --no-open