Communitygithub.com

解說資訊圖表

生成一個動態、互動式的 HTML 頁面,透過現實類比、視覺圖表和漸進式揭露來解釋複雜概念。當使用者要求「解說資訊圖表」、「解釋 X 如何運作」、「製作解說」、「將此概念視覺化」、「幫我視覺化理解 X」或以簡單視覺格式分解主題時使用。輸出是單一自包含的 HTML 檔案,使用者可在瀏覽器中開啟、捲動或分享為連結。主題可以是任何內容 — 金融概念、技術系統、科學流程、商業框架。

解說資訊圖表 是什麼?

這個技能會根據提示產生一個自包含的單一 HTML 檔案,以長捲軸、互動式視覺化方式解釋複雜概念,風格類似 Bartosz Ciechanowski、The Pudding 或 distill.pub。它著重於漸進式揭露:從一個引人入勝的鉤子開始,引入一個強烈的現實類比,然後逐步引導使用者了解機制(包含圖表、動畫和可選的深入互動),闡明常見誤解,最後以一個令人印象深刻的要點作結。內容和視覺風格優先考慮清晰度、可讀性(大段落、高行高、SVG 圖表)和目的性動畫。技術上,它依賴於行動裝置友善、無障礙且快速的純 HTML/CSS/JS,不需要外部函式庫或載入延遲。此技能適用於教育內容、技術解說、簡報或任何需要讓複雜主題對聰明非專家也易於理解且難忘的場合。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/chalhoub120-png/opencode-skills-curated/tree/HEAD/skills/explainer-infographic

在你喜歡的 AI 中提問

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

說明文件

解說資訊圖表 是做什麼的?

您建立一個單一 HTML 檔案,像優秀的視覺解說員(如 Bartosz Ciechanowski、The Pudding、distill.pub)一樣解釋概念:透過捲動、互動圖表、現實類比和漸進深度。輸出應該讓一個聰明的非專家在 5 分鐘內理解一個複雜主題。

開始之前

先掌握基本要素:

  1. 概念 — 您要解釋什麼?
  2. 受眾 — 誰要讀?(預設為聰明非專家)
  3. 「為何現在」 — 這是為了會議、課程、影片、部落格文章,還是個人學習?
  4. 深度 — 快速直覺(一個畫面)或更深層探索(長捲軸)?

如果未指定,預設為:聰明非專家,深度足以捲動 3-5 分鐘,無特定使用案例。

結構

大多數概念可以用 5 個節拍來解釋。依此順序建構頁面:

1. 鉤子(一個畫面)

以一個問題或驚人事實開場,讓這個概念值得理解。不是「什麼是 X」——而是像「為什麼建在水上的橋樑從空盒子開始?」或「為什麼 30 年房貸的總成本是房價的兩倍以上?」

2. 類比

將不熟悉的概念連結到讀者已知的事物。這個類比應該貫穿頁面其餘部分,而不是在介紹後就丟掉。範例:

  • LLM 就像「強化版的預測文字」
  • 現金流就像「水流過水管」
  • DNS 就像「網際網路的電話簿」

選擇一個強烈的類比並堅持使用。混合類比會讓讀者混淆。

3. 機制(3-7 個章節)

依序說明事物實際運作的方式。每個章節應包含:

  • 一個清晰的標題
  • 一個簡短段落
  • 一個視覺元素 — 圖表、動畫或互動元素
  • (可選)一個「點擊深入」的揭露區塊,給好奇的讀者

這是頁面的核心。視覺元素是它與部落格文章不同的關鍵。

4. 常見誤解

一個簡短章節,說明人們對這個主題常犯的錯誤。格式為「迷思:X / 現實:Y」的配對。

5. 要點

一段總結,將所有內容連結回第 1 節的鉤子。留給讀者一句他們可以在晚宴上重複的話。

視覺風格

  • 米白或暖白背景 — 在長時間閱讀時比純白背景更不傷眼
  • 寬鬆排版 — 內文 18-20px,行高 1.6+,最大寬度 65 字元
  • 一種強調色 — 用於強調、連結和每個圖表中的關鍵元素
  • SVG 圖表 — 在任何縮放下都清晰,可透過 CSS 設定主題
  • 動畫有目的性,非裝飾性 — 動畫用來顯示隨時間的變化(一個過程展開、數值增長、系統反應)。不要為了動畫而動畫。
  • 在適合的地方使用捲動驅動 — 對於序列和流程,使用觸發於捲動的動畫,讓讀者控制節奏。對於靜態圖表,則跳過捲動觸發。

互動元素(每頁最多使用 2-3 個)

  • 滑桿/範圍輸入 — 調整參數並查看效果
  • 切換開關 — 在兩種狀態之間切換(有/無、之前/之後)
  • 點擊揭露 — 給好奇讀者的額外詳細資訊
  • 逐步動畫 — 「下一步」按鈕,讓讀者按自己的節奏逐步瀏覽流程

不要過度使用。三個精心設計的互動時刻勝過十個噱頭。

技術實作

單一自包含的 .html 檔案,儲存為 explainer-[主題縮寫].html。無外部依賴項 — 內嵌任何字型,內聯撰寫 SVG,僅使用原生 JS。

要求:

  • 行動裝置友善 — 大多數讀者會在手機上捲動
  • 無障礙 — 語意化 HTML,圖表提供替代文字,互動元素可鍵盤導航
  • 快速 — 應立即開啟,無載入圖示,無資源載入延遲

內容規則

  1. 以類比開頭,而非定義。「神經網路是一個函數近似器」雖然正確但無用。「神經網路就像一堆調光開關,它們學會自行調高或調低」則很有用。
  2. 使用真實數字。「大多數房貸為 30 年」很籠統。「一筆 50 萬美元的房貸,利率 7%,30 年總成本為 120 萬美元 — 其中 70 萬美元是利息」則令人印象深刻。
  3. **展示,而非告知。**如果你發現自己在寫「想像如果...」,請考慮是否可以直接用圖表展示。
  4. **不要耍聰明。**機智可以;但過度努力的幽默會分散解說的注意力。目標是清晰,而不是娛樂。
  5. **以問題或啟示結尾。**一個優秀的解說會讓讀者思考,而不僅僅是獲得資訊。

為何這樣建構

長篇文字解說容易略讀和遺忘。投影片對於細節來說過於壓縮。一個可捲動的視覺頁面處於兩者的最佳中間點:長度足以深入,視覺效果足以令人難忘,互動性足以引發參與。做得好時,這個格式會讓讀者截圖並分享。

生成後

告知使用者:

  1. 檔案路徑
  2. 如何開啟
  3. 一個他們可以要求以改進的具體事項(你還沒完成 — 解說的第一版草稿通常需要一輪「X 章節感覺薄弱」的修改)
  4. 如何分享 — 檔案是自包含的,所以他們可以通過電子郵件傳送、放到 Slack 中、或託管在任何地方

相關技能