Communitygithub.com

解释器信息图

生成一个动画式的交互式HTML页面,通过现实世界类比、可视化图表和渐进式解释来阐明复杂概念。

解释器信息图 是什么?

该技能旨在通过创建自包含的HTML文件,将复杂概念转化为直观、沉浸式的解释性内容。它特别适合开发者、教育工作者或任何需要以简洁、视觉吸引人的方式传达复杂主题的人。该技能支持任何平台,因为输出是一个单一的HTML文件,可在任何浏览器中打开,无需外部依赖。生成的页面采用渐进式叙事结构:以引人入胜的钩子开始,使用相关的类比,通过带有交互式SVG图表的机制部分进行讲解,纠正常见误解,并以令人难忘的要点结束。视觉风格优先考虑清晰度和可访问性,具有暖色背景、宽泛的排版、适度的动画和最多三个互动元素(如滑块、切换开关或逐步动画)。此方法区别于标准博客文章或演示文稿,因为它在深度和参与度之间取得了平衡,使抽象主题变得具体且易于分享。该技能严格遵守规则,包括使用真实数据、展示而非讲述、以及避免过于幽默,确保最终输出以清晰和理解为优先,而非娱乐性。

兼容平台~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倍?”这样的问题。

2. 类比

将不熟悉的概念与读者已知的事物联系起来。该类比应在页面其余部分持续使用,而不是在介绍后丢弃。示例:

  • 大型语言模型作为“增强版预测文本”
  • 现金流作为“水流过管道”
  • DNS作为“互联网的电话簿”

选择一个强有力的类比并坚持使用。混合类比会使读者困惑。

3. 机制(3-7个部分)

按顺序讲解事物实际是如何工作的。每个部分:

  • 一个清晰的标题
  • 一个简短的段落
  • 一个视觉元素——图表、动画或交互式元素
  • (可选)一个“点击深入探究”揭示区域,供好奇者使用

这是页面的核心。视觉元素是使其与博客文章不同的地方。

4. 常见误解

一个简短的部分,处理人们对这个主题常犯的错误。格式为“误解:X / 现实:Y”对。

5. 要点

一个段落,将所有内容与第1部分的钩子联系起来。给读者留下一个可以在晚宴上复述的句子。

视觉风格

  • 米白色或暖白色背景——长时间阅读比纯白色更护眼
  • 宽泛的排版——正文18-20px,行高1.6+,最大宽度65ch
  • 一种强调色——用于高亮、链接以及每个图表中的关键元素
  • SVG格式图表——在任何缩放级别下清晰,可通过CSS设置主题
  • 动画有目的性,而非装饰性——动画用于展示随时间的变化(过程展开、数值增长、系统反应)。不要仅为动画而动画。
  • 滚动驱动在需要时使用——对于序列和过程,使用滚动触发的动画,让读者控制节奏。对于静态图表,跳过滚动触发。

交互式元素(每页最多使用2-3个)

  • 滑块/范围输入——调整参数并查看效果
  • 切换开关——在两个状态之间切换(有/无,之前/之后)
  • 点击揭示——为好奇读者提供的额外细节
  • 逐步动画——“下一步”按钮,以读者自己的节奏逐步浏览过程

不要过度使用。三个精心设计的交互时刻胜过十个噱头。

技术实现

单一自包含的.html文件,保存为explainer-[主题缩写].html。无外部依赖——嵌入任意字体,内联编写SVG,仅使用原版JavaScript。

要求:

  • 移动端友好——大多数读者会在手机上滚动浏览
  • 可访问——语义化HTML,图表具有替代文本,交互元素可通过键盘导航
  • 快速——应瞬间打开,无加载动画,无资源加载延迟

内容规则

  1. 以类比而非定义开头。 “神经网络是一个函数逼近器”是正确的但无用。“神经网络就像一堆调光开关,学习如何调高或调低自己”是有用的。
  2. 使用真实数字。 “大多数按揭贷款持续30年”是泛泛而谈。“一笔50万美元的按揭贷款,利率7%,30年总成本为120万美元——其中70万美元是利息”是令人印象深刻的。
  3. 展示而非讲述。 如果你发现自己写“想象一下...”,考虑是否可以直接用图表来展示。
  4. 不要卖弄聪明。 机智可以;过分努力的笑话会分散解释的注意力。目标是清晰,而非娱乐。
  5. 以问题或含义结尾。 一个好的解释器让读者思考,而不仅仅是知情。

为何如此构建

长篇文本解释器容易被略读和遗忘。幻灯片对于细微差别来说过于压缩。滚动式视觉页面处于恰到好处的中间地带:足够长以提供实质内容,足够视觉化以令人难忘,足够交互以吸引参与。做得好时,这种格式会让读者截图并分享。

生成之后

告知用户:

  1. 文件路径
  2. 如何打开它
  3. 一件他们可以要求改进的特定事项(你还没完成——解释器的初稿通常需要一轮“X部分感觉薄弱”的修改)
  4. 如何分享——文件是自包含的,所以他们可以邮件发送、放到Slack、或托管在任何地方

相关技能