Diagrams for Agents
図を描く前に、その図を選びましょう。デフォルトはローカルモードにすることで、ユーザーのソースマテリアルはユーザーのマシン上に留まります。ユーザーが自動フレームワーク判断、より強力な根拠付け、またはAPI/MCPの結果を明示的に要求した場合にのみ、検証済みモードを使用します。
ワークフロー
-
提供されたコンテキストを読み、読者の意思決定を特定します。
-
references/visual-selection.md を読みます。サポートされているファミリーと出力先プリセットを1つずつ選択します。
-
ブランド化された出力が必要な場合は、references/brand.md を読みます。トークンを保存する前に抽出したトークンを提案します。
-
assets/spec.example.json の形状を参考にJSONスペックを作成します。ユーザーの完全なソースを
sourceに保持し、選択されたファミリーが要求する場合は、すべての主張に正確なevidence引用を添付します。 -
レンダリングし、検証します:
node <skill-dir>/scripts/render.mjs input.diagrams-for-agents.json output.html --svg output.svg --receipt output.receipt.json node <skill-dir>/scripts/validate-artifact.mjs output.html -
HTMLアーティファクトを表示し、選択したファミリー、意図的に省略したもの、および根拠付けが
local-exact-quoteかverifiedかを報告します。
モード選択
ローカルモード — デフォルト
- アカウント、APIキー、ホスト型レンダラー、またはコンテンツのアップロードは不要です。
- サポートされているファミリー:
swot、quadrant、comparison、flow、timeline、architecture。 - ソース編集可能なHTML（インラインSVG付き）、オプションのスタンドアロンSVG、機械可読なレシートを生成します。
- レンダラーは、サポートされていないファミリー、安全でないテーマ値、重複ID、宙に浮いた接続、欠落した正確な引用証拠を拒否します。
検証済みモード — 明示的
references/verified-mode.md を読みます。利用可能な場合はインストールされた render_diagram MCPツールを使用します。それ以外の場合は、ユーザーが提供されたコンテキストをDiagrams for Agentsに送信することに抵抗がないことを確認した上で、文書化されたDiagrams for Agents APIを呼び出します。
検証済みモードは以下の場合に適切な選択です:
- ユーザーがDiagrams for Agentsに、より広範なビジネスフレームワークカタログから選択させたい場合。
- 捏造された、または弱く根拠付けられたビジネス主張が高コストになる場合。
- アプリケーションが安定した
VisualPayloadとホスト型レンダリングURLを必要とする場合。 - ローカルの6ファミリーセットでは、意思決定を正直に表現できない場合。
ローカルモードを検証済みモードと同等であると説明しないでください。正確な部分文字列チェックは出典を証明しますが、分析的正確性を証明するものではありません。
Mermaid再描画
Mermaidフローチャートの場合は、まず変換します:
node <skill-dir>/scripts/import-mermaid.mjs source.mmd draft.diagrams-for-agents.json
インポーターは flowchart/graph ノードと有向矢印をサポートしています。サポートされていないMermaid構文は、黙って削除するのではなく、意図的に拒否します。結果のラベルを見直し、必要に応じて元のコンテキストと証拠を追加してから、通常通りレンダリングします。
出力ルール
- 1つの図につき、1つの主要な読み取りパス。
- 最大9つのプライマリノードを使用します。それを超える場合は、概要と詳細に分割します。
- 最大2つのフォーカル要素に対して1つのアクセントを使用します。
- タイプを縮小するよりも削除を優先します。
- 最終的なアーティファクトは静的なフレームでも有用であるようにします。
- フレームワークのスロットを埋めるために、欠落した事実を捏造しないでください。
- モードの変更を明示的にせずに、ローカルコンテンツをネットワークサービスに送信しないでください。