Diagram Design教學手冊
diagram-design 教學手冊 diagram-design —— 給 AI Coding Agent 使用的「編輯級圖表設計系統」企業導入完整指南 Version:2.6.7(依 .claude-plugin/plugin.json 查證,2026-08-28 查證時之最新版本;細節見下方「版本標示重要澄清」) Research Date:2026-08-28 適用對象:Software Developer、Tech Lead、Software Architect、AI Architect、Technical Writer、DevSecOps 工程師 目的:協助企業軟體開發團隊將 diagram-design 導入「AI Coding Agent 產出架構圖 / 流程圖 / 技術文件」的日常工作流程,取代品質參差的 AI 手畫 Mermaid 圖表 Repository:github.com/cathrynlavery/diagram-design(MIT License) 技術堆疊:Python 3.x(腳本/驗證工具)、Playwright + Chromium(PNG 匯出)、純 HTML + Inline SVG + CSS(產出格式,無前端框架、無建置流程) 重要聲明(請務必先讀) 本手冊是彙整、重組、補充企業導入實務,而不是官方文件的翻譯。 內容依官方 Repository(README.md、skills/diagram-design/SKILL.md、skills/diagram-design/references/*.md 全部 39 個 type-*.md 索引與其中多篇全文、style-guide.md、onboarding.md、docs/adr/*.md、.claude-plugin/plugin.json、.github/workflows/ci.yml、完整檔案樹)逐檔查證後,以繁體中文重新組織、延伸為企業教材,並大量補充 Scenario、AI Prompt 範例、比較表與 Checklist。 diagram-design 不是「畫圖工具」,而是給 AI Coding Agent 使用的「圖表設計系統」(Diagram Design System)。 它的核心產出不是「畫出一張圖」,而是「用一致的設計語言、版面規則、色彩紀律,把 AI 對架構的理解轉譯成可直接發佈的 HTML + SVG 文件」。本手冊會不斷強調這個核心觀念:Skill 提供的是規則與知識(Layout Rule、Complexity Budget、Design Token),實際畫圖的仍是 AI Agent 本身。 ...