Community影像github.com

imagen-infographic

設計並渲染 NotebookLM 風格的資訊圖表(標題帶、編號模組面板、簡單圖示或迷你圖表、來源頁尾)以及人物與概念互動的平面場景插圖(例如開發人員在桌前工作、沮喪或解脫,螢幕上可選顯示圖表),並透過 imagen CLI 輸出為 PNG。適用於需要資訊圖表、一頁視覺摘要、解說海報、文章/部落格/簡報/電子報的視覺重點,或是開發人員相關的插圖,即使對方沒說「資訊圖表」也沒關係。不適用於來自 mermaid 的流程圖或架構圖(請用 imagen-diagrams)或照片與封面藝術(請用 image-gen)。

imagen-infographic 是什麼?

這項技能專門用於生成 NotebookLM 風格的資訊圖表與人物場景插圖。它提供了一套嚴謹的設計流程,從撰寫規格(Markdown + YAML 前端說明)開始,接著進行 lint 檢查(強制執行單一訊息、資料來源、視覺類型限制、簡潔原則與 WCAG 無障礙對比),然後透過 imagen CLI 渲染成 PNG,最後再自動讀回圖片驗證文字拼寫是否正確。技能支援多種主題與長寬比,內建多種針對資料的圖表類型(長條圖、折線圖、流程圖等),並禁止使用 3D、圓餅圖等可能誤導或無意義的視覺元素。此外,它還能產生包含人物與情境的平面場景插圖,為技術文章增添個人化溫度。此技能適用於 Claude Code、Cursor、Codex 等支援 imagen CLI 的開發環境,主要依賴 `imagen` CLI 與 `imagen-diagrams` 插件。透過結構化的規則與自動化檢查,它能幫助開發者快速創建高品質、易於理解的視覺化內容。

相容平台✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/SpillwaveSolutions/imagen-infographic/tree/HEAD

Installed? Explore more 影像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

在你喜歡的 AI 中提問

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

說明文件

imagen-infographic 是做什麼的?

一份好的資訊圖表能將複雜資訊在數秒內轉化為清晰、好記且易於掃讀的內容。它將理解度置於裝飾之上。這項技能將其轉化為可重複的流程:撰寫規格、進行 lint 檢查、渲染圖片,以及驗證回來的文字。

設計規則(在撰寫規格前請先閱讀)

  1. 單一明確訊息 你必須能用一句話說明整份資訊圖表的內容。先寫下那句話,作為 message。headline 應陳述重點,讓讀者約五秒內掌握核心。兩個相互競爭的想法就做成兩張資訊圖表,或者放在同一個文章段落裡。

  2. 準確、可信的資料。 僅使用原始來源的事實。每個數字都必須附帶來源,且頁尾應列出所有來源。誤導性的比例或經過挑選的數字,比起完全沒有圖表更容易摧毀信任。

  3. 指定單一受眾。 將複雜度與詞彙調整至該讀者已知的程度。一個通用的概述對任何人都沒有幫助。

  4. 層次與動線。 大小、對比與擺放位置引導視線的走向:先是標題,再來是面板標籤,最後是簡短詞組。採用從上到下的順序或清晰的模組化網格。

  5. 為資料選擇正確的視覺類型。

    • bar 用於比較。
    • line 用於隨時間變化的趨勢。
    • timeline 或 process 用於流程。
    • diagram 用於關係。
    • comparison 用於並排比較。
    • stat 用於一個很大的數字。
    • icons 或 checklist 用於簡短列表。

    不得使用 3D、切片過多的圓餅圖,以及沒有意義的裝飾。lint 會拒絕 pie、donut、radar 和 3d。

  6. 簡潔與克制。 保持標籤簡短、詞組更短。使用 2 或 3 種字體與 2 到 4 種顏色,並留出充足的留白。如果某個區塊需要一整段文字,那它屬於文章本身,而非資訊圖表。

  7. 無障礙性。 文字對比度至少必須達到 4.5:1,腳本會進行檢查。絕不能只靠顏色來區分不同項目:必須加上標籤。圖片在手機上必須能清晰閱讀。

  8. 一致性。 使用統一的圖示風格、一套字體系統,以及均勻的間距。提示詞已要求這些,所以不要用混亂的指令去破壞它。

失敗模式:在渲染前請檢查規格是否有這些問題:

  • 資訊過載,或主題太多
  • 漂亮但無意義的裝飾
  • 層次薄弱,讓讀者需要費力尋找重點
  • 錯誤或扭曲的圖表
  • 缺少來源
  • 無法閱讀的文字

工作流程

  1. 找出訊息。 閱讀來源(文章段落、報告、筆記)。寫下單一句子的 message 並選擇 audience。如果你無法寫出一句話,代表素材還不適合製作資訊圖表。
  2. 撰寫規格:一個帶有 YAML 前端說明的 Markdown 檔案。完整格式與範例請參考 references/spec-format.md。使用 3 到 6 個面板,每個面板需有簡短標籤、一個視覺類型,以及最多 3 個短語或少量資料點。
  3. 進行 lint 檢查:
    python3 ~/.claude/skills/imagen-infographic/scripts/infographic.py lint SPEC.md --theme arctic-fox
    
    lint 會強制執行規則 1、2、5、6、7 中的限制,並為每個問題印出一行。請修正規格,而不是調整限制:每個限制的存在,都是因為過去的資訊圖表若未遵守就會失敗。
  4. 渲染:
    python3 ~/.claude/skills/imagen-infographic/scripts/infographic.py render SPEC.md -o out.png --theme arctic-fox
    
    • --theme 可使用任何 imagen-diagrams 的主題 ID,它會填入色板與風格。你也可以在規格中設定 palette:。
    • 預設長寬比為 3:4(直式海報)。若為投影片則設定 aspect: "16:9"。
    • 腳本會在圖片旁寫出 out.prompt.txt,讓你可以看到請求的內容。使用 --dry-run 可以僅印出提示詞而不進行實際渲染。
  5. 驗證關卡。 腳本會使用 imagen analyze 重新讀取圖片。標題、每個面板標籤以及來源頁尾都必須出現且拼寫正確。腳本最多會嘗試 3 次(--attempts),並刪除失敗的圖片,因此失敗會留下明顯的缺口,而非破損的圖片。
  6. 親自檢查結果 開啟 PNG 檔案並根據上述八條規則進行比對。驗證關卡只檢查拼寫,無法告訴你層次是否薄弱或圖表比例是否失調。如果圖片違反規則,請修改規格(減少文字、更換視覺類型)並重新渲染。

當你將圖片嵌入文章時,請為它加上圖說與一段簡短文字來說明圖片內容。無法看到圖片的讀者仍應能理解訊息。

場景:人物與點子互動

場景是一張平面插圖,描繪文章所述時刻中的人物:開發人員抓著頭面對長長的聊天記錄、測試通過時鬆了一口氣、在白板上草擬計畫。場景能讓技術文章更具個人化風格。場景可以在螢幕或白板上顯示文章中的一個圖表,將人物與概念連結起來。每篇文章大約使用一個場景,放在人物感到沮喪或解脫的時刻。

python3 ~/.claude/skills/imagen-infographic/scripts/infographic.py scene SCENE.md -o scene.png --theme arctic-fox

場景規格是一個簡短的前端說明區塊(請參考 references/spec-format.md):person(誰、在做什麼、感受如何)、setting、可選的 diagram(相對於規格的 PNG 路徑,作為參考圖片傳送)、theme 或 palette,以及 aspect(預設為 16:9)。場景本身不帶任何文字,因此沒有文字驗證關卡。請檢查每個場景:情緒必須一目了然,且圖片不得包含標題、圖說或對話框。

需求

  • PATH 中須有 imagen CLI(gemini-imagen),並配置好有效的金鑰。
  • imagen-diagrams 插件:用於 --theme 及其 generate.py 中的引擎容錯機制。若無此插件,腳本會直接呼叫 imagen generate,你必須在規格中設定 palette:。
  • Python 3 與 PyYAML。

在你修改腳本後,請執行 infographic.py --self-test。它會檢查 lint 和對比度規則,而不會實際呼叫圖片生成。

相關技能