imagen-infographic 是做什麼的?
一份好的資訊圖表能將複雜資訊在數秒內轉化為清晰、好記且易於掃讀的內容。它將理解度置於裝飾之上。這項技能將其轉化為可重複的流程:撰寫規格、進行 lint 檢查、渲染圖片,以及驗證回來的文字。
設計規則(在撰寫規格前請先閱讀)
-
單一明確訊息 你必須能用一句話說明整份資訊圖表的內容。先寫下那句話,作為
message。headline應陳述重點,讓讀者約五秒內掌握核心。兩個相互競爭的想法就做成兩張資訊圖表,或者放在同一個文章段落裡。 -
準確、可信的資料。 僅使用原始來源的事實。每個數字都必須附帶來源,且頁尾應列出所有來源。誤導性的比例或經過挑選的數字,比起完全沒有圖表更容易摧毀信任。
-
指定單一受眾。 將複雜度與詞彙調整至該讀者已知的程度。一個通用的概述對任何人都沒有幫助。
-
層次與動線。 大小、對比與擺放位置引導視線的走向:先是標題,再來是面板標籤,最後是簡短詞組。採用從上到下的順序或清晰的模組化網格。
-
為資料選擇正確的視覺類型。
bar用於比較。line用於隨時間變化的趨勢。timeline或process用於流程。diagram用於關係。comparison用於並排比較。stat用於一個很大的數字。icons或checklist用於簡短列表。
不得使用 3D、切片過多的圓餅圖,以及沒有意義的裝飾。lint 會拒絕
pie、donut、radar和3d。 -
簡潔與克制。 保持標籤簡短、詞組更短。使用 2 或 3 種字體與 2 到 4 種顏色,並留出充足的留白。如果某個區塊需要一整段文字,那它屬於文章本身,而非資訊圖表。
-
無障礙性。 文字對比度至少必須達到 4.5:1,腳本會進行檢查。絕不能只靠顏色來區分不同項目:必須加上標籤。圖片在手機上必須能清晰閱讀。
-
一致性。 使用統一的圖示風格、一套字體系統,以及均勻的間距。提示詞已要求這些,所以不要用混亂的指令去破壞它。
失敗模式:在渲染前請檢查規格是否有這些問題:
- 資訊過載,或主題太多
- 漂亮但無意義的裝飾
- 層次薄弱,讓讀者需要費力尋找重點
- 錯誤或扭曲的圖表
- 缺少來源
- 無法閱讀的文字
工作流程
- 找出訊息。 閱讀來源(文章段落、報告、筆記)。寫下單一句子的
message並選擇audience。如果你無法寫出一句話,代表素材還不適合製作資訊圖表。 - 撰寫規格:一個帶有 YAML 前端說明的 Markdown 檔案。完整格式與範例請參考
references/spec-format.md。使用 3 到 6 個面板,每個面板需有簡短標籤、一個視覺類型,以及最多 3 個短語或少量資料點。 - 進行 lint 檢查:
lint 會強制執行規則 1、2、5、6、7 中的限制,並為每個問題印出一行。請修正規格,而不是調整限制:每個限制的存在,都是因為過去的資訊圖表若未遵守就會失敗。python3 ~/.claude/skills/imagen-infographic/scripts/infographic.py lint SPEC.md --theme arctic-fox - 渲染:
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可以僅印出提示詞而不進行實際渲染。
- 驗證關卡。 腳本會使用
imagen analyze重新讀取圖片。標題、每個面板標籤以及來源頁尾都必須出現且拼寫正確。腳本最多會嘗試 3 次(--attempts),並刪除失敗的圖片,因此失敗會留下明顯的缺口,而非破損的圖片。 - 親自檢查結果 開啟 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 中須有
imagenCLI(gemini-imagen),並配置好有效的金鑰。 - imagen-diagrams 插件:用於
--theme及其generate.py中的引擎容錯機制。若無此插件,腳本會直接呼叫imagen generate,你必須在規格中設定palette:。 - Python 3 與 PyYAML。
在你修改腳本後,請執行 infographic.py --self-test。它會檢查 lint 和對比度規則,而不會實際呼叫圖片生成。