# 宝玉信息图件首拆：两维正交造图法——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/.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 的一行军规。 ## 六、工作流七步：交互经济学与防呆军规 工作流部分是全文最长的一节，七步走完一次完整生产。用一张图看全貌： ```mermaid 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. **备份、有界重试、一次问清**——覆盖先改名加时间戳，失败重试至多一次，确认问题合并在一次调用里。这三条分别对应用户的后悔权、模型的止损点、用户的注意力税。 ## 十、安装与使用 ```bash # 方式一：skills CLI 装整个家族（三件一起进目录） npx skills add JimLiu/baoyu-skills # 方式二：手动克隆到 Claude Code 技能目录 git clone https://github.com/JimLiu/baoyu-skills ~/.claude/skills/baoyu-skills ``` 装好后在本机即有 `/baoyu-infographic` 命令，典型调用： ```bash /baoyu-infographic content.md --layout funnel --style corporate-memphis --aspect portrait --lang zh /baoyu-infographic notes.md # 什么都不选，走默认：bento-grid + craft-handmade ``` ## 推荐排行榜 - **学 SKILL.md 工程写法**：1. baoyu-infographic（本期主拆：正交维度 + 索引式披露 + 目录树契约 + 防呆军规四件齐活） 2. 官方 skill-creator（写法模具，本刊已有专期） 3. obra/superpowers（流程方法论框架，本刊已有专期） - **中文视觉内容生产**：1. baoyu-xhs-images（平台深度适配，据 05-18 期记录） 2. baoyu-infographic（通用信息图主力） 3. markdown-to-image（零配置快速出口） - **出图速度**：1. markdown-to-image（一步直出） 2. baoyu-infographic 默认组合（零选项直出） 3. baoyu-infographic 全流程精调（质量优先） ## 诚实条款 本轮会话在线搜索与网页抓取通道均未放行，本文 SKILL.md 原文全部引自本机装机副本逐字实读，星数与社区事实引自本刊 2026-05-18、06-30、07-10、09-07 各期存档（18.1K 星为 05-18 时点值，未获今日实时复核）；baoyu-xhs-images 内部实现未装机实读，相关评分系存档推断并已标注※；references 目录 42 个引用文件的存在性以主文件引用清单为据，未逐一打开验证；加权评分为本期口径复算，与前存档期不同权重口径不可直接比大小。 ## 参考来源 1. [JimLiu/baoyu-skills](https://github.com/JimLiu/baoyu-skills) — 主拆对象仓库；SKILL.md 原文引自本机装机副本（`~/.claude/skills/baoyu-infographic`）全文实读 2. [anthropics/skills](https://github.com/anthropics/skills) — 官方技能仓库，本文设计模式对照（skill-creator 模具，本刊已有专期） 3. [JimLiu/baoyu-design](https://github.com/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 等场景全覆盖。