Communitygithub.com

lnardev/diagram-design

生成可獨立運作的 HTML 檔案(內嵌 SVG + CSS),產出出版物等級的編輯用架構圖、系統流程圖、資料管線圖與順序圖。

diagram-design 是什麼?

此技能專為需要高品質、可發表圖表的開發者與 AI 代理(如 Claude Code)設計。它提供一個嚴謹的視覺設計系統,包含特定的色彩、字體與 SVG 幾何佈局規則,確保所有圖表風格一致且專業。使用者只需遵循「4px 格線規範」與「正交連接線」等規則,即可產出編輯等級的圖表,適用於技術文件、系統設計審查或研究成果發表。此技能支援所有能渲染 HTML 的平台,因為最終輸出為自包含的 HTML 檔案。其運作方式基於一份詳盡的 SKILL.md 文件,定義了從色彩調色盤、字型組合到 SVG 結構模板的所有規範,AI 代理依此生成符合設計標準的內嵌 SVG 與 CSS 代碼。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/lnardev/lean-agent-harness/tree/HEAD/skills/diagram-design

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

編輯圖表設計

生成清晰、可發表的圖表,作為單一自包含的 HTML 檔案(內嵌 SVG + CSS)。嚴禁使用通用的深青色發光、預設的 Mermaid 版面配置或對角連接線。

視覺 DNA 與色彩調色盤

  • 紙張(背景): #f5f5f5(平面畫布)。
  • 墨水(文字與主要筆觸): #2d3142。
  • 柔和(次要文字與標準線條): #4f5d75。
  • 邊框與分隔線: rgba(45, 49, 66, 0.12)。
  • 強調色(瓶頸/關鍵焦點): #eb6c36(珊瑚/陶土色;每個圖表最多 1–2 個焦點節點)。
  • 外部/鬆散邊界: 虛線筆觸(stroke-dasharray="4,4")。

字體排版(Google 字型)

在 HTML 標頭中嵌入: <link href="https://fonts.googleapis.com/css2?family=Instrument+Serif:ital@0;1&family=Geist:wght@400;500;600&family=Geist+Mono:wght@400;500;600&display=swap" rel="stylesheet">

  • 圖表標題: Instrument Serif,28px,正常粗細。
  • 節點名稱: Geist(無襯線),12px,粗細 600。
  • 子標籤與中繼資料: Geist Mono,9px(連接埠、協定、批次間隔)。
  • 連接器徽章/眉毛文字: Geist Mono,7–8px,大寫,字距調整(letter-spacing: 0.08em)。

SVG 幾何與佈局標準

  1. 4px 格線規範: 所有座標(x、y)、尺寸(width、height)、內邊距與間距必須為 4 的倍數。
  2. 僅限正交連接器: 嚴禁在偏離軸心的節點之間繪製對角斜線。每個彎折必須是帶有圓角(r=8)的直角肘形。嚴格保留直線 <line> 僅用於共享相同軸線的節點。
  3. 遮罩連接器徽章: 將協定/資料標籤(例如 CSV、XLSX、LOAD)放置在填滿 #f5f5f5(rx=2)的不透明 <rect> 內。在標籤與線條筆觸之間保持 6px–10px 的可見間距,使標籤永不切穿箭頭。
  4. 區域與功能容器: 將步驟分組為寬廣的欄位/區域(例如 COLLECTION、PROCESSING、DISSEMINATION)。使用 1px 邊框(rgba(45,49,66,0.12))、圓角(rx=8)以及在左上角放置一個大寫等寬字型標題標籤。
  5. 節點層級:
    • 標準: 填滿 #ffffff,筆觸 #2d3142 1px,圓角半徑 6px(rx=6)。
    • 瓶頸/痛點: 填滿 #fbeee8(rgba(235,108,54,0.08)),筆觸 #eb6c36。
    • 外部: 透明或白色填滿,虛線邊框(stroke-dasharray="4,4")。
  6. 水平底部圖例: 在圖表節點下方放置一條水平圖例條,並以全寬的極細分隔線隔開。

結構性 SVG 範本

在撰寫 SVG 之前,請載入 references/template.md(標記、區域、連接器、遮罩徽章、節點方塊)。

相關技能