首页 › skills-review › 宝玉信息图件首拆:两维正交造图法

宝玉信息图件首拆:两维正交造图法——baoyu-infographic 逐段精读

概述

本期是 Skills 生态拆解第 2 轮,回到这个栏目的老手艺:把一件 Skill 拆到 SKILL.md 逐段精读的级别。这次上手术台的是中文社区内容创作赛道星数最高的项目——宝玉(@dotey)开源的 JimLiu/baoyu-skills 三件套中的主力件 baoyu-infographic(本刊 2026-05-18 期存档记录全仓库 18.1K 星)。它此前在 07-10 期「前端审美六强横评」和 09-07 期「持久层」讨论中两次以配角出场,但从未被整件拆开。本次拆解的原文底本不是网页转述,而是本机装机副本的 SKILL.md 全文实读——拆解条件照例如实声明:本轮在线通道未放行,星数与社区数据引自本刊各期存档,凡超出副本原文与存档的推断逐一标注※。

先给结论:这件 Skill 的 SKILL.md 是目前中文社区里把「渐进式披露」「数据与表现分离」「防呆军规」三件事同时做满的范本。它用 20 种版式 × 17 种风格的两根正交轴,把信息图设计压成了一个 340 种组合的选择题,而全文只用了不到一千词。

评测对比表

件 核心定位 功能 25% 设计 25% 实战 20% 上手 15% 社区 15% 加权总分
baoyu-infographic 通用信息图引擎(20 版式 × 17 风格) ★★★★★ ★★★★★ ★★★★ ★★★★ ★★★★ 4.50
baoyu-xhs-images 小红书图文系列(10 风格 × 8 布局)※ ★★★★½ ★★★★ ★★★★ ★★★★ ★★★★ 4.13
markdown-to-image Markdown 转图片海报(固定 3:4) ★★★ ★★★½ ★★★★ ★★★★★ ★★★½ 3.70

评分说明:三件为同仓库家族对照,本次主拆对象是第一件。xhs-images 的分项主要依据本刊 05-18 期的功能记录(封面图、内容分页、引导关注页等平台适配),未做装机实读※;markdown-to-image 曾在 06-30 期「数据即交付」实测中拿过 3.40 的加权分(当期权重口径不同,此处按本期五维口径复算)。社区分押在同仓库 18.1K 星、更新频繁、站外教程成规模的存档事实上。

一、第一行就是产品定义:两根正交轴

SKILL.md 开篇没有寒暄,没有背景介绍,直接是一句产品纲领:

Two dimensions: layout (information structure) × style (visual aesthetics). Freely combine any layout with any style.

翻译过来:两个维度,版式管信息结构,风格管视觉气质,任意版式配任意风格自由组合。这一行值得所有想写 Skill 的人抄进笔记本,因为它解决的是提示词工程里最经典的组合爆炸问题。如果把 20 种版式各自写成一份完整提示词,再乘 17 种风格,理论上要维护 340 份文件;而把两个维度声明为正交轴之后,维护成本骤降为 20 + 17 = 37 份定义文件,组合数却一个不少。数学上这是乘法分配律,工程上这是关注点分离——内容怎么摆,和内容长什么气质,是两个互不干扰的变量。

对照着看就能看出门道:官方 skill-creator 教你写结构,superpowers 教你写流程,而 baoyu-infographic 展示的是第三种写法——把领域知识分解成可自由组合的维度。领域一旦能正交分解,SKILL.md 就从「一份长指令」变成「一张乘法表」。

二、两张画廊表:词汇表即接口

紧跟着纲领的是全文的主体:两张表。第一张 Layout Gallery,20 行,每行两列——版式名和「Best For」(最适场景):

版式(节选) Best For
linear-progression Timelines, processes, tutorials
binary-comparison A vs B, before-after, pros-cons
iceberg Surface vs hidden aspects
funnel Conversion, filtering
story-mountain Plot structure, tension arcs
bento-grid(默认) Multiple topics, overview

这 20 个名字本身就是一门隐喻词汇表:冰山、漏斗、桥、拼图、隧道地图、故事山——每个名字压缩了一整套信息结构的直觉。注意设计的巧妙之处:作者没有写「如果内容是流程就用 X,如果是对比就用 Y」的决策树,而是给每个版式配一列 Best For,让 agent 自己对号入座。这是一种信任式接口——给词汇和判据,不给死板的分支逻辑,模型的语言本能会完成剩下的匹配。

第二张 Style Gallery,17 行:craft-handmade(手作纸艺,默认)、claymation(黏土定格)、kawaii、chalkboard(黑板报)、cyberpunk-neon、technical-schematic(工程蓝图)、lego-brick(乐高积木)……每个风格名是一次文化引用,模型对这些词自带视觉记忆,一个词就能召唤一整套配色、质感和构图惯例。这两张表合起来,就是这件 Skill 的全部「API 面」:调用者只需要会说这两个词表里的词。

尤其值得注意的是每张表下面那句不起眼的英文:Full definitions: references/layouts/<layout>.md。SKILL.md 里只放索引,每个版式和风格的完整定义躺在 references 目录里按需加载——20 + 17 份定义,加上分析框架、结构化模板、基础提示词、偏好配置、首次引导共 5 份框架文件,全件共 42 个引用文件,但常驻上下文的只有主文件里那两张索引表。这就是官方反复讲的渐进式披露,在这里不是原则而是算术:上下文窗口是按 token 计费的仓库,只把目录搬进去,货架留在仓库里。

三、默认值哲学与预制菜单:少问少错

选项区给了四个开关:--layout、--style、--aspect(横 16:9 / 竖 9:16 / 方 1:1)、--lang。关键在于每个开关都有兜底:版式默认 bento-grid(便当格,万能的多主题概览),风格默认 craft-handmade。也就是说,用户哪怕只敲一句 /baoyu-infographic content.md 什么都不选,也一定能出一张体面的图——有主见的默认值胜过把选择成本转嫁给用户。

默认组合之外还有第三层保险:一张 12 行的 Recommended Combinations 预制菜单,「时间线内容配 linear-progression + craft-handmade」「技术内容配 structural-breakdown + technical-schematic」「A 对 B 配 binary-comparison + corporate-memphis」……工作流第三步要求基于内容结构推荐 3-5 组组合,这张表就是推荐时的弹药库。三件套连起来读:默认值管「零思考可用」,推荐菜单管「低思考可选」,两张画廊管「全思考可精调」——选择成本的三个梯度都被照顾到了。

四、输出目录树:把工程纪律写进文件系统

SKILL.md 里有一段很少在提示词里见到的东西——一个目录树契约:

infographic/{topic-slug}/
├── source-{slug}.{ext}
├── analysis.md
├── structured-content.md
├── prompts/infographic.md
└── infographic.png

命名规则:slug 取自主题的 2-4 个词,kebab-case;冲突时追加 -YYYYMMDD-HHMMSS。这五个文件是一场数据到表现的完整流水线存档:原始素材、分析笔记、结构化中间稿、最终提示词、成品图。

这里藏着全文最值得抄的一个观念:prompts/infographic.md 被当作一等公民单独落盘。意味着在这件 Skill 的世界观里,PNG 只是缓存,提示词文件才是源代码——图不满意可以改提示词重新生成,图是怎么来的有据可查,换一个图像生成件也能用同一份提示词复现。本刊 09-07 期「持久层」讨论过 Skill 世界「文件是唯一人人可用的持久介质」,这个目录树就是该论点的正面样板:审计性、可复现性、可迁移性,全部靠把中间产物写成文件来实现。

五、数据洁癖宪法:逐字保真写进 Core Principles

Core Principles 一节只有三条,第一条加粗:

Preserve all source data verbatim—no summarization or rephrasing

所有源数据逐字保留,禁止概括和转述。第二、三条要求先定义学习目标再做结构化、为视觉传达而结构化(标题、标签、视觉元素)。三条合起来是一条清晰的分工线:结构化层只许动信息的骨架,不许动信息的血肉——统计数据、引语、事实在 structured-content.md 里必须和原文一字不差,能改的只有摆放方式和强调方式。

在幻觉是头号生产事故的当下,这条宪法相当于把「不编数」从期望变成了流程约束:数据层冻结,表现层自由。信息图这种体裁最容易出事的地方恰恰是模型「顺手四舍五入」,这件 Skill 把最容易出事的环节用一行加粗文本焊死了。数据新闻行业的老规矩——数字必须可回溯到源——被翻译成了 SKILL.md 的一行军规。

六、工作流七步:交互经济学与防呆军规

工作流部分是全文最长的一节,七步走完一次完整生产。用一张图看全貌:

flowchart TB
    A["输入:内容文件或粘贴文本"] --> B["Step 1 分析:读 EXTEND.md 写 analysis.md"]
    B --> C["Step 2 结构化:structured-content.md 数据逐字保真"]
    C --> D["Step 3 推荐:3至5组 版式乘风格 组合"]
    D --> E["Step 4 确认:一次 AskUserQuestion 问清全部选项"]
    E --> F["Step 5 拼装:版式定义加风格定义加基础模板"]
    F --> G["Step 6 生成:调图像件出 infographic.png 失败重试一次"]
    G --> H["Step 7 汇报:主题 版式 风格 比例 语言 路径"]
    R["references 42个定义文件 按需加载"] -.-> F

三处细节见功力。

第一处,EXTEND.md 双层配置。第一步先找配置文件,项目级 .baoyu-skills/baoyu-infographic/EXTEND.md 优先于用户级 $HOME/.baoyu-skills/...——优先级顺序和编辑器、linter 的配置约定完全同构。EXTEND.md 支持偏好版式/风格、默认比例、自定义风格定义、语言偏好。这是在给 Skill 铺平台化的后路:用户可以往风格库里塞自己的品牌风格,Skill 的行为随配置生长而本体不用改。

第二处,交互经济学。第四步原文写着:用一次 AskUserQuestion 调用合并确认所有选项,并特别加粗警告「Do NOT split into separate AskUserQuestion calls」——组合永远问、比例永远问、语言只在源文和用户语言不一致时才问。作者显然被反复弹窗烦过,才会写下这条:用户的每一次确认都是要付费的往返,能合并的问题绝不拆开问。这是把交互成本意识写进了流程定义。

第三处,防呆军规。工作流里散布着四处备份点——source.md、analysis.md、prompts/infographic.md、infographic.png 四个产物,凡是已存在的一律先改名为 原名-backup-YYYYMMDD-HHMMSS 再写入;第六步生成失败「auto-retry once」,只重试一次。这里做一次漂亮的交叉验证:本刊 09-07 期「持久层」与「防呆」两期曾从另一渠道记录过该件的军规原文——「任何要覆盖的文件先改名 *-backup-YYYYMMDD-HHMMSS」外加「失败自动重试一次」的有界重试——与本机装机副本逐字吻合。两个独立来源对上,这条军规的真实性可以盖章。在全生态回滚件数量为零的背景下(09-07 期量过:回滚件生态一件都没有),这一行改名规则就是用户唯一的后悔药。

七、可插拔的最后一公里:它管想清楚,别的件管画出来

第六步的原文还有一个容易被略过的短语:「Select available image generation skill (ask user if multiple)」——图像生成不是内建能力,而是调用环境里已有的图像生成 Skill,多个就问用户选哪个。这件 Skill 因此把自己定位成了纯粹的「大脑件」:内容分析、结构化、版式选择、提示词拼装是它的全部职责,画图是别人的事。这与本刊多期讨论的 Skill 组合化趋势互为印证——单件做窄做深,能力靠装配叠加。对用户的好处是图像模型升级时(换模型、换服务商)这件 Skill 一行不用改。

八、适用与不适用

适用:结构化知识讲解(教程、科普、方法论)、数据型内容(榜单、对比、转化漏斗)、课程与内训材料、中文社媒长图。内容结构性越强,版式词汇表的匹配越准——它的两根轴就是为「把概念讲清楚」设计的。

不适用:强时效热点图——七步流程加一次确认交互,走完需要耐心,追热点时不如一次性生成命令快;严格品牌合规场景——17 种风格是自有词汇表而非品牌 token 体系,需要靠 EXTEND.md 自定义风格补课;以及「要一张氛围图」这类无结构需求——没有结构可分析的输入,版式轴无从发力。

短板也照实记:流程重意味着轻场景有固定开销;风格库再大也是封闭集合,审美上限取决于 17 份风格定义的写作质量(本次装机实读未逐个打开 references 文件,风格定义内部质量存疑※);全部产物落盘对洁净癖用户可能显得啰嗦——但按本刊持久期的立场,这是 feature 不是 bug。

九、给想写自己第一份 SKILL.md 的你:五条可抄清单

  1. 开头一行写产品定义,能正交就正交——把领域拆成可组合的维度,用乘法表代替 340 份重复提示词。
  2. 词汇表即接口——给每个选项一个自带直觉的隐喻名和一列「Best For」,让模型自己匹配,别写死决策树。
  3. 索引进正文,定义进 references——主文件只放表格和流程骨架,重货按需加载,上下文窗口是仓库不是货架。
  4. 中间产物落盘,提示词是源代码——成品图可以重画,分析稿和拼装好的提示词必须可审计、可复现。
  5. 备份、有界重试、一次问清——覆盖先改名加时间戳,失败重试至多一次,确认问题合并在一次调用里。这三条分别对应用户的后悔权、模型的止损点、用户的注意力税。

十、安装与使用

# 方式一:skills CLI 装整个家族(三件一起进目录)
npx skills add JimLiu/baoyu-skills

# 方式二:手动克隆到 Claude Code 技能目录
git clone https://github.com/JimLiu/baoyu-skills ~/.claude/skills/baoyu-skills

装好后在本机即有 /baoyu-infographic 命令,典型调用:

/baoyu-infographic content.md --layout funnel --style corporate-memphis --aspect portrait --lang zh
/baoyu-infographic notes.md   # 什么都不选,走默认:bento-grid + craft-handmade

推荐排行榜

诚实条款

本轮会话在线搜索与网页抓取通道均未放行,本文 SKILL.md 原文全部引自本机装机副本逐字实读,星数与社区事实引自本刊 2026-05-18、06-30、07-10、09-07 各期存档(18.1K 星为 05-18 时点值,未获今日实时复核);baoyu-xhs-images 内部实现未装机实读,相关评分系存档推断并已标注※;references 目录 42 个引用文件的存在性以主文件引用清单为据,未逐一打开验证;加权评分为本期口径复算,与前存档期不同权重口径不可直接比大小。

参考来源

  1. JimLiu/baoyu-skills — 主拆对象仓库;SKILL.md 原文引自本机装机副本(~/.claude/skills/baoyu-infographic)全文实读
  2. anthropics/skills — 官方技能仓库,本文设计模式对照(skill-creator 模具,本刊已有专期)
  3. JimLiu/baoyu-design — 同作者设计增强件(据本刊 2026-07-10 期「去AI味:前端审美六强横评」记录)
  4. 本刊存档 2026-05-18 期 — baoyu-skills 三件套首记(18.1K 星、三件构成、xhs-images 平台适配记录)
  5. 本刊存档 2026-09-07 期「持久层」与「防呆」两期 — 备份军规与有界重试的引文出处,与本文装机副本交叉验证

[!tip] 51学通信知识星球 星主:爱卫生(微信:gprshome201101)——公众号「51学通信」创办者,19 年通信行业运维与讲师经验,著有《GPRS网络信令实例详解》《EPC原理与实践》《5G核心网原理与实践》三本纸质书(各大电商平台有售)。 星球定位:深耕 5G 核心网、IMS、NFV/AI、云原生等 ICT 领域,主打运维岗位与信令分析。 当前规模:5200 篇主题 / 990 个回答,198 元/年。 加入福利:加入星球后请加爱卫生微信,拉您进知识星球年度陪伴与答疑群——不限量回复您的各种问题,另有群内分享。 AI 加持:51学通信知识星球已作为 skill 接入 WorkBuddy,使用 deepseek-4-flash 在海量星球帖子中精准找贴、找视频、找 FAQ 和案例,做总结、找文档和 PPT 等场景全覆盖。

51学通信知识星球海报-扫码加入