diagram-generator

diagram-generator 技能總覽

diagram-generator 的用途

diagram-generator 技能可讓你用結構化輸入來建立與編輯 drawio、Mermaid 和 Excalidraw 圖表，不必再一個節點一個節點手工搭建。它最適合想把粗略的架構、流程或拓樸概念，轉成可直接使用的圖檔，而且希望少一點試錯的人。

最適合的情境與真正要完成的工作

如果你的目標是產出可直接放進文件的系統、流程或網路圖，而且你同時在意產生速度與後續可編輯性，那就很適合用 diagram-generator。它最強的使用場景，是技術使用者需要乾淨輸出，之後可以納入原始碼管理、在 GUI 裡再微調，或隨需求更新重新生成。

你需要知道的關鍵差異

diagram-generator 的主要價值在於支援多種格式，且能讀取既有的 .drawio、.mmd 和 Excalidraw 檔案。這一點很重要，因為你不一定要從零開始，而是能直接更新舊圖。它也依賴 MCP server，這能減少吃 token 的手動格式化，並讓輸出比一般 prompt 更一致。

什麼情況下它不是最佳選擇

如果你只是想快速畫一張一次性的草圖，之後沒有要存檔或再編輯，那單純下 prompt 就可能夠用。當格式正確性、可重現性，以及後續編輯的重要性高於一張大致像樣的示意圖時，diagram-generator 才更有價值。

如何使用 diagram-generator 技能

安裝並確認 MCP 相依套件

在進行 diagram-generator install 時，先加入這個技能，並確認對應的 server 已可用，再要求輸出。這個技能需要 mcp-diagram-generator；如果 server 不在，生成就可能失敗，或產出不完整結果。請先確認 server 暴露的工具，再在環境就緒後使用這個技能。

從正確的輸入形式開始

好的 diagram-generator usage 會從一段精簡但完整的說明開始，包含圖表類型、目標格式、受眾，以及必須納入的實體。比如說：「Create a Mermaid sequence diagram for login flow: browser, auth service, database, include success and failure paths.」這比單純說「做一張登入流程圖」更好，因為它提供了足夠的結構，讓技能能判斷版面、標籤與範圍。

先閱讀這些檔案

若要把 diagram-generator guide 用得更實際，先讀 SKILL.md，再查看 references/json-schema-guide.md 了解輸入結構，並讀 references/format-selection-guide.md 來選擇 draw.io、Mermaid 或 Excalidraw。若你要做的是網路圖，references/network-topology-examples.md 是最快理解預期巢狀結構與命名模式的方法。

能產出更好結果的工作流程

建議依這個順序進行：先選格式、再寫短規格、先生成一次，最後只針對錯誤的部分修正。保持節點名稱穩定，明確描述階層，並說清楚圖表應偏重可讀性、緊湊性，還是手動可編輯性。例如，與其把版面決策留白，不如直接要求「draw.io for a layered infrastructure diagram with environment > datacenter > zone > device, optimized for later GUI edits」。

diagram-generator 技能 FAQ

diagram-generator 比一般 prompt 更好嗎？

是的，當你需要結構化檔案、可重複的格式，或要修改既有圖表時，diagram-generator 會更有優勢。一般 prompt 可以描述圖表，但當你想要的是支援格式中的真實輸出檔，而不是近似圖片的結果時，diagram-generator 更強。

我該選哪一種格式？

Mermaid 適合快速、方便放進 Markdown，且適合版本控管的圖表。draw.io 適合需要手動微調的複雜架構或拓樸。Excalidraw 則適合較鬆散的視覺風格，或輕量草圖。當 diagram-generator 技能的格式選擇能對應工作目標，而不是事後再猜時，價值最大。

初學者可以用 diagram-generator 嗎？

可以，但初學者如果先提供少量結構，通常會得到更好的結果：圖表目的、實體、關係，以及偏好的格式。這個技能不難用，但輸入太模糊時，圖表往往需要第二輪修正。

什麼時候應該避免使用？

如果你的圖表很講究藝術感、需要品牌插畫風格，或仰賴高度客製化的視覺設計，超出技術圖表的範圍，就不適合用 diagram-generator。另外，如果你的環境無法安裝或存取必要的 MCP server，也應該避免使用。

如何提升 diagram-generator 技能成效

把技能無法自行推斷的決策講清楚

提升品質最大的關鍵，是明確指定格式、受眾與細節深度。請說明要強調什麼：相依關係、流程方向、權責邊界、環境層級，或失敗路徑。對 diagram-generator 來說，這些選擇通常比元件清單本身更重要。

降低實體與關係的模糊度

常見失敗模式包括名稱含糊、箭頭缺漏，以及圖表混用不同抽象層級。與其只說「顯示系統」，不如提供像「API gateway, auth service, billing service, Postgres, Redis」這樣有邊界的清單，並說明它們如何連接。如果你要做的是網路圖，務必明確定義階層，避免技能自行猜測容器層級。

一次只修正一個重點

第一次輸出後，請只針對一項內容要求修正：重新命名節點、簡化版面、切換格式，或補上一條缺漏的關係。這樣可以避免 diagram-generator 失焦，卻仍持續改善最終檔案。如果結構錯了，先修結構；如果標籤錯了，再修標籤。

善用 repository 參考來精準化未來的提示

如果第一次結果已經接近但不夠理想，就回頭對照 references/json-schema-guide.md 或 references/format-selection-guide.md，再調整輸入，使其符合預期模型。提升 diagram-generator usage 最快的方法，就是弄清楚哪些限制該寫進 prompt，哪些限制應該交給 diagram schema。