Diagrams for Agents
先選擇視覺，再繪製它。預設為「本地模式」，讓使用者的原始材料保留在其機器上。僅在使用者要求自動框架判斷、更強的依據或 API/MCP 結果時，才使用「驗證模式」。
工作流程
-
讀取提供的內容，並識別讀者的決策。
-
閱讀 references/visual-selection.md。選擇一個支援的圖表家族和一個目的地預設。
-
若要產生品牌化輸出，閱讀 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； - 本地六個圖表家族無法如實呈現該決策。
切勿將本地模式描述為等同於驗證模式。精確的子字串檢查只能證明來源，而非分析的正確性。
Mermaid 重繪
若要處理 Mermaid 流程圖，首先進行轉換：
node <skill-dir>/scripts/import-mermaid.mjs source.mmd draft.diagrams-for-agents.json
匯入器支援 flowchart/graph 節點和方向箭頭。它會刻意拒絕不支援的 Mermaid 語法，而非默默地忽略。請檢查產生的標籤，視需要加入原始內容和證據，然後正常渲染。
輸出規則
- 一個圖表，一條主導的閱讀路徑。
- 最多使用九個主要節點；若超出則將概覽與細節拆分。
- 使用一個強調色，最多標注兩個焦點元素。
- 偏好刪除而非縮小字型。
- 確保最終成品在靜態框架中仍具可用性。
- 絕不為了填滿框架欄位而虛構缺失的事實。
- 未明確告知模式變更前，絕不將本地內容傳送至網路服務。