Community影像github.com

chaos-xxl/keynote-visual-explainer

將產品觀點、AI/技術原理、系統架構、流程、對比或抽象概念,製作成具有 Apple Keynote 發表會質感的中文/英文解釋型配圖。

keynote-visual-explainer 是什麼?

此技能專為開發者與 AI 代理設計,用於將複雜的產品觀點、AI/技術原理、系統架構、流程對比或抽象概念,轉化為具有 Apple Keynote 發表會般高級質感的解釋型配圖。它強調「一眼看懂」的關係與機制,以精簡的視覺語言(如淺色高留白、柔和 3D 造型、克制配色)取代繁複的細節,讓使用者能快速理解核心結構。技能支援 Apple Keynote、Claude Code、Cursor、Codex 等主流平台,並在 SKILL.md 中提供一套從內容提煉到生成校對的完整工作流程。工作流程涵蓋結構分析、佈局選擇(如單鏈流程、雙欄對比、分層架構)、視覺參考圖選用、文字控制策略,以及嚴格的生成後校對程序。此外,它內建了精細的圖像生成提示詞骨架,確保在需要時能直接輸出高品質圖片,或在僅支援提示詞的環境下提供精確的複製貼上文本,從而節省開發者的迭代時間。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/chaos-xxl/keynote-visual-explainer/tree/HEAD

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

在你喜歡的 AI 中提問

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

說明文件

Keynote Visual Explainer

把一段文字提煉成一眼理解機制、關係與差異的高品質解釋圖。視覺取向借鑒 Apple Keynote 發表會的簡潔、精密與克制,但不複製 Apple 標誌、官方插畫或特定頁面。準確性先於好看,結構先於細節。

使用時機

  • 用戶要求「延續之前 Apple Keynote 那種風格」「給文字配圖」「圖解概念」「畫系統架構」「對比三種路線」。
  • 適配產品原理、AI Agent、作業系統、技術路線、服務流程、商業模式、隱喻說明。
  • 遇到明確的靜態配圖要求,直接產出圖片(如當前運行環境支援影像生成);不要只回傳一段繪圖提示詞來代替圖片。環境僅支援提示詞時,應提供完整可複製的生成提示詞並誠實說明。
  • 不應強行用於精確工程藍圖、精確統計圖、真實 UI 截圖、硬性品牌素材規範。精確圖表/工程圖應選擇能校驗結構的繪圖工具。

核心設計準則(優先級從高到低)

  1. 內容正確:忠實區分參與者、資源、權限、流程、邊界、依賴;不要為了對稱而編造邏輯。
  2. 主旨唯一:觀眾應在三秒內識別唯一主要結論。把原文壓縮成 1 個核心關係 + 2–6 個要素;架構大圖允許 5–9 個分組節點。
  3. 關係可見:靠空間、形態、路徑、因果箭頭表達,不靠大量標註補救模糊結構。
  4. 克制、透氣:足夠大的留白、少量重點元素、清晰的閱讀路徑,拒絕無意義裝飾。
  5. 系列一致:相同的人物、元件、箭頭、卡片和顏色語義在同一組圖中保持一致。

工作流程

1. 先把文字變成結構

在內部確認:

  • 唯一想說明的結論是什麼?
  • 有哪些實體(如用戶、導購、商店;Trigger、Router、Worker)?
  • 實體之間是流向、控制、歸屬、條件分支,還是並列比較?
  • 哪些細節會改變原意(安全邊界、資源來自誰、誰做決策、誰執行、是否動態更新)?這些必須保留。
  • 什麼只是例子、情緒修飾、修辭?可以省略。

不應把所有段落逐字轉成圖片。優先抽象,但不能把兩種機制畫成相同流程。

2. 用讀者需要看懂的關係決定構圖

先問讀者要看懂的是「先後怎麼發生」「誰負責什麼」,還是「幾種做法差在哪」。選擇一個主版式,具體例子見 結構版式:

  • 一條鏈:輸入 → 核心決策/轉換 → 輸出(流程、權力交接)。
  • 雙/三欄對比:共享視覺基準,僅突出不同規則或控制權。
  • 分層架構:當讀者需要區分互動、協調和執行時,優先按職責分層。在畫布上給核心調度角色最大的視覺分量,讓並行執行單元同層排列,把共享能力放在旁側或底層。讀 分層架構示例。
  • 前後變化:過去與現在,展示一個關鍵關係的增刪。
  • 二維曲線/座標:清晰軸向、曲線、少量錨點;位置必須與原文的方向相符。
  • 生活隱喻:廚房、旅行社、商場等場景,場景服務於機制,不做人物故事海報。

預設畫幅 16:9 橫向,PPT/Keynote 適配;用戶指定其他比例時以用戶要求為準。

生成前寫清楚畫布上的相對位置:第一眼看哪裡、各角色放在哪一層、哪幾個元素同級、輔助能力放在哪裡。把這些位置和尺寸關係寫進提示詞。箭頭只補充有意義的方向、回傳或邊界,避免為每個技術名詞排一個等大的圖示。

3. 選一張參考圖,作為實際生成輸入

  1. 選圖。優先使用用戶指定的圖或本對話中用戶選定的上一張成圖。沒有指定時,選同類的內置樣圖:分層架構用 分層架構樣圖,多方案對比用 三欄樣圖,單場景概念用 簡潔樣圖,關係流程用 廚房流程樣圖。佈局不匹配時,只參考它的光線、材質和配色。
  2. 把圖傳入生成器。先查看圖片,再透過生成工具的參考圖或編輯圖輸入附上實際圖片,按工具支援的方式使用檔案、圖片附件或已生成圖。提示詞裡提到檔案名不等於傳入圖片。若當前工具只能接收文字,說明這次採用文字近似,並按 視覺規範 寫明具體特徵。
  3. 區分視覺沿用與內容替換。同一張圖的局部修改,將原圖作為編輯目標,明確鎖定位置、比例、造型、光線和排版。為新題目出圖,將樣圖作為風格參考,只有結構合適時才沿用佈局。根據新題目決定實體、文字、工位數量和箭頭,不從樣圖繼承舊內容。

未指定畫風時,從 視覺規範 選取與參考圖一致的特徵:

  • 背景:瓷白 / 霧白,極輕的冷灰藍漸變,柔和工作室光,無明顯紋理。
  • 主體:簡潔 2.5D / 柔和 3D,奶白啞光陶瓷、磨砂塑膠、少量陽極氧化金屬;形體圓潤、邊緣精準,真實但不過度寫實。
  • 人物:無五官、白瓷材質、圓潤人偶。角色分工是主旨時,優先給不同職責可識別的造型(如用戶、排程員、執行工位);設備、資源和儲存則用對應物件。僅在隱喻與實際職責相符時使用。
  • 配色:霧藍、淺灰、中性白為主;亮藍只強調主路徑;薄荷綠強調成功/許可,暖橙/柔紅僅用於風險/異常。
  • 構圖:嚴格對齊、統一大小和視角、易識別剪影、圓角基座/卡片、小而軟的落地陰影。
  • 線條:流向實線箭頭、狀態/條件虛線箭頭;避免箭頭穿過物件或多處交叉。
  • 氣質:高級、安靜、友好、技術感、編輯式克制。像精心排版的發表會一頁,不像操作手冊拼貼。

4. 控制文字

優先遵循用戶的明確約束:

  • 用戶說 「不要任何文字」「純圖形」:完全不出現標題、標籤、字母、數字、Logo、浮水印;用物體形態、空間關係與箭頭解釋。
  • 用戶沒有要求無字:保留一條主標題及必要標籤。示範型架構圖允許在關鍵層或核心角色旁加一條短職責說明(如「接單 · 派單 · 回傳」);這行應幫助讀者理解職責。保留 A2UI、Intelligent UI、Router、Worker 等必要術語。
  • 用戶提供長文時:不要把整段文章排進圖片;文字只是必要的消岐,不是主要載體。
  • 若生成器中文文字穩定性欠佳,則進一步減字、用圖示與後期可編輯標註代替;不要犧牲語義準確性。

5. 生成前校對結構,生成後檢查成圖

  • 3 秒測試:能否不看正文就認出關鍵參與者和主關係?
  • 對比測試:每一種路線真正不同的點是否在畫面中可見?
  • 因果測試:箭頭方向正確嗎?條件變化、權限邊界、控制主體有沒有畫反?
  • 層級測試:縮到簡報縮圖大小時,是否仍能認出唯一視覺重心,並區分互動層、執行層和輔助能力?標題或輔助模組是否搶了主角的分量?
  • 刪減測試:刪掉任何一個裝飾元素,會不會更清爽?如果會,刪掉。
  • 一致性測試:同一角色在不同分鏡中是否同形,同一顏色是否同義?
  • 約束測試:比例/無字/節點數量/用戶提供的術語是否被嚴格遵守?

若結果太複雜,優先減少物件、標註、卡片層數與次要場景,不要只是縮小字體或壓縮間距。 看成圖時逐條核對關鍵連線的起點、終點、方向和分支數量,並檢查圖中文字。發現主從關係、分支基數或文字錯誤時,修正後再交付。 要求延續畫風時,將成圖與選中的參考並排看,核對背景冷暖、藍色覆蓋面積、角色輪廓和比例、標題位置與輔助資訊的視覺分量。若偏離,保留參考圖做有針對性的編輯。

影像生成提示詞骨架

生成影像時,按任務動態填充。不要在用戶不需要時展示此內部提示詞。

Create ONE polished Apple-Keynote-inspired editorial 3D explainer illustration,
wide 16:9, on a warm porcelain-white background with an almost imperceptible
cool-blue gradient. Use minimalist soft-clay and matte ceramic forms, precise
rounded geometry, elegant studio lighting, delicate shadows, ample negative space,
and a restrained palette of ivory, slate-gray and soft blue.

CORE CLAIM: [one-sentence takeaway].
IMAGE INPUT: [attached reference image or edit target; which visual traits
to retain, what content to replace, and what geometry is fixed].
COMPOSITION: [reading order, focal subject and relative size, placement of
layers or groups, position of supporting capabilities].
VISUAL ENTITIES: [essential roles and the recognizable form that expresses each].
RELATIONSHIPS: [source, target, direction and one-to-one/one-to-many meaning
of each necessary connection; group related elements before adding arrows].
CRITICAL DISTINCTIONS: [the facts that must not be visually conflated].

Visual storytelling over text. Every object has a semantic purpose.
Keep silhouettes instantly recognizable. Consistent perspective, scale,
lighting, arrow design and color semantics throughout.

TEXT POLICY: [absolutely no text / exact labels and any short role descriptions].

AVOID: busy infographic dashboards, long copy, decorative filler, excessive
icons, overly glossy glassmorphism, neon, sci-fi holograms, generic blue robots,
heavy borders, crowded panels, random badges, repeated redundant scenes,
logos, watermarks and confusing arrows.

難點處理

  • 深層架構圖:先確定講的是角色分工還是事件流。歸併同一職責的實現細節,僅展開會改變讀者理解的權限、狀態或異常路徑。
  • 一句話可以畫清的事情:不要做多宮格大資訊圖;一幅統一場景或一個三節點關係更好。
  • 技術機制 + 日常隱喻:保留技術真實關係,隱喻只做角色映射。不要因隱喻方便而改變協議、執行權或資源邊界。
  • 系列配圖:如需連續多張,優先固定人物/主色/俯視角度/箭頭表達,以相同模板替換實體;不要每張隨機重新發明風格。

參考資料

按需讀取:

  • references/visual-system.md:造型、材質、色彩、排版、常見失敗模式。
  • references/composition-patterns.md:針對不同資訊關係的結構選擇方法及三個真實題材示例。

技能包中的樣圖用於傳遞視覺特徵。圖中的技術名詞和連線只適用於各自的題目。分層構圖可結合 架構示例 使用。

相關技能