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 frontmatter 的 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
一个场景规格是一个简短的 frontmatter 块(参见 references/spec-format.md):person(谁,做什么,感受如何)、setting、可选的 diagram(相对于规格的 PNG 路径,作为参考图像发送)、theme 或 palette 以及 aspect(默认 16:9)。场景本身不携带文本,因此没有文本门控。检查每一个:情绪必须一目了然,图像不得有标题、说明文字或对话气泡。
要求
- 可执行
imagenCLI(gemini-imagen),且位于 PATH 中,并配有有效的密钥。 - imagen-diagrams 插件,用于
--theme及其在generate.py中的引擎故障切换。如果没有该插件,脚本将直接调用imagen generate,你必须在规格中设置palette:。 - Python 3 并安装 PyYAML。
更改脚本后,运行 infographic.py --self-test。它会在不发起任何图像调用的情况下检查 lint 和对比度规则。