mermaid-visualizer

Mermaid Visualizer 是一款專為將抽象文字描述轉換為結構化視覺文件而設計的代理技能。它專為需要快速在 Obsidian 或 GitHub 環境中生成清晰、專業級圖表的技術文檔撰寫者、軟體架構師與產品經理打造。透過封裝 Mermaid 庫的複雜語法，此技能確保輸出的圖表語法有效、視覺風格一致且易於閱讀。

該技能支援多種視覺化類型，包括流程圖、循環回饋系統、層次化心智圖、時序圖與狀態轉換圖。它能智慧處理常見的解析錯誤，例如列表語法衝突、不當的子圖嵌套以及節點參照錯誤，讓使用者能專注於概念的釐清而非除錯。

• 進階語法防錯：自動應用錯誤緩解模式，處理列表編號、子圖命名及特殊字元跳脫問題。

• 智慧佈局控制：提供圖表方向（TB, LR）、細節層級（簡單到詳細）及專業語意樣式的配置選項。

• 多元圖表類型：支援流程圖、循環流程、比較分析、心智圖、時序圖與狀態機。

• Obsidian 深度整合：輸出針對 Obsidian 渲染優化的 Mermaid 程式碼區塊，確保與現有 Markdown 文件無縫對接。

• 策略性視覺輸出：能夠生成標準、詳細或適合簡報展示的圖表，滿足不同專案階段的需求。

• 輸入：提供描述性提示詞或結構化文字，定義欲視覺化的流程、關係或架構。

• 配置：使用如 'layout: horizontal' 或 'detail: simple' 等選用參數來客製化生成的 Mermaid 圖表。

• 約束條件：請務必確保節點參照使用 ID 而非顯示文字；代理會強制執行此標準以防止解析失敗。

• 最佳實踐：適用於系統架構圖、AI 代理工作流、決策樹及複雜流程文件，在維護性與清晰度至關重要時尤其有效。