diagram

Diagram 技能是專為實踐「圖表驅動開發」(DDD) 的開發人員與架構師所設計的專業工具。它有助於建立、同步與維護儲存在 ai/diagrams 儲存庫中的「統一影響圖」。與標準的技術文件不同，DDD 著重於連結前台用戶體驗與後台技術實作。此技能確保每個系統圖表都能成為代碼庫的精確反映，並強迫明確定義技術組件與其交付的用戶價值之間的連結。

• 使用 Mermaid 語法自動生成與更新序列圖、架構圖及功能流程圖。

• 執行全面審核，透過交叉比對檔案歷程與儲存庫結構，偵測過時或缺失的圖表。

• 管理 README.md 中的所有視覺化文件索引，維持系統理解的單一事實來源。

• 根據 DDD 原則驗證技術圖表，確保其包含影響註釋、以用戶為中心的進入點以及錯誤路徑復原紀錄。

• 執行嚴格的命名規則與組織模式（功能、旅程、架構、測試、重構），保持專案文件的易讀性。

• 結合重構前/後的視覺化紀錄，並利用顏色高亮顯示系統改進，提高系統透明度。

• 使用者在執行操作前，必須先透過 Read 工具讀取相關參考文件（如 DDD_PRINCIPLES.md, CREATE.md, MERMAID_GUIDE.md），以確保符合品質標準。

• 輸入通常包含功能規格或代碼變更紀錄，輸出則為包含 Mermaid 圖表、關鍵洞察與清晰變更歷史的結構化 Markdown 檔案。

• 限制條件包括禁止使用自訂顏色（重構影響指標 #90EE90 除外），並要求每個圖表必須平衡技術深度與用戶導向的影響力。

• 此工具非常適合尋求減少技術債、提升新貢獻者架構導入效率，並確保功能開發與用戶旅程需求保持一致的敏捷團隊。