Community图像github.com

imagen-infographic

设计并渲染 NotebookLM 风格的信息图(标题栏、编号模块化面板、简单图标或迷你图表、来源页脚)以及人物与创意互动的扁平场景插画(如开发者坐在桌前,或沮丧或释然,可选带屏幕上的图表),使用 imagen CLI 生成 PNG。

imagen-infographic 是什么?

imagen-infographic 技能将复杂信息转化为清晰、可记忆且易于快速浏览的视觉格式,遵循设计规则确保可读性与可访问性。它支持为文章、博客、幻灯片或新闻稿创建信息图,以及为技术文章添加扁平场景插画(描绘开发者工作状态)。 该技能在渲染前强制进行 lint 检查(包括单一信息、引用数据、简洁性、WCAG 对比度),渲染后验证图像文本拼写,并支持 3 次重试。主要平台为 Claude Code 等支持 imagen CLI 和 Python 环境的 AI 代理,依赖 imagen CLI、imagen-diagrams 插件和 PyYAML。 工作原理:用户编写包含 YAML frontmatter 的 Markdown 规格文件,指定消息、受众、面板和视觉类型,然后依次执行 lint、render 和文本门控验证,确保只生成质量和可读性达标的图像。

兼容平台✓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 frontmatter 的 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

一个场景规格是一个简短的 frontmatter 块(参见 references/spec-format.md):person(谁,做什么,感受如何)、setting、可选的 diagram(相对于规格的 PNG 路径,作为参考图像发送)、theme 或 palette 以及 aspect(默认 16:9)。场景本身不携带文本,因此没有文本门控。检查每一个:情绪必须一目了然,图像不得有标题、说明文字或对话气泡。

要求

  • 可执行 imagen CLI(gemini-imagen),且位于 PATH 中,并配有有效的密钥。
  • imagen-diagrams 插件,用于 --theme 及其在 generate.py 中的引擎故障切换。如果没有该插件,脚本将直接调用 imagen generate,你必须在规格中设置 palette:。
  • Python 3 并安装 PyYAML。

更改脚本后,运行 infographic.py --self-test。它会在不发起任何图像调用的情况下检查 lint 和对比度规则。

相关技能