ian-xiaohei-illustrations:给文章画小黑配图

2,358 字 · 预计阅读 7 分钟

这个 Skill 几乎没有脚本,也没有数据,只有一份写得极清楚的风格说明书,让 AI 每次画出同一种画风。

写技术文章、教程、方法论,配图往往最费事。让 AI 生图,常见的结果是每张风格都不一样:要么是商业感很重的扁平插画,要么是塞满文字的 PPT 信息图。

它给的做法是固定一个角色小黑,再固定一套画风。纯白背景、黑色手绘线稿、少量红橙蓝的中文手写批注,小黑在画面里认真地做一件有点荒诞的事。

它由 helloianneo 开发,MIT 许可。咱们网站的配图也用它,先看两张仓库里的示例图:

示例:两个断点(Ian 生成,仓库自带的风格校准样例)

示例:信任桥(Ian 生成,仓库自带的风格校准样例)


一、先说一个重要前提:它是为 Codex 写的

README 第一句就写着:这是一个 Codex Skill。SKILL.md 里的生图步骤,用的是 Codex 内置的生图工具 image_gen。

Claude Code 本身不能生成图片。所以在 Claude Code 里用它,要分两种情况:

你想做的 在 Claude Code 里能不能做
分析文章、输出配图清单(shot list) 能,这部分只需要读和写
按模板写出每张图的生图提示词 能
直接生成图片 要另外接一个能生图的工具(比如一个生图类的 MCP 服务器),或者把提示词拿到能生图的工具里去

Skill 是跨工具的格式,但 Skill 里用到的工具不一定跨工具。装之前读一遍 SKILL.md,看它依赖什么,就不会装完才发现跑不起来。


二、安装

README 给的是装进 Codex 的方法:

bash
git clone https://github.com/helloianneo/ian-xiaohei-illustrations.git
cd ian-xiaohei-illustrations
cp -R ./ian-xiaohei-illustrations "${CODEX_HOME:-$HOME/.codex}/skills/"

要装进 Claude Code,只要换个目标目录:

bash
cp -R ./ian-xiaohei-illustrations ~/.claude/skills/

注意要复制的是仓库里的子目录 ian-xiaohei-illustrations/,不是整个仓库。根目录的 README、LICENSE、示例图是给人看的分享文档。


三、打开看看:一份风格说明书

ian-xiaohei-illustrations 的文件夹结构

ian-xiaohei-illustrations/
├── SKILL.md                      ← 工作流:消化正文 → 出配图清单 → 单张生成 → 检查 → 交付
├── agents/openai.yaml            ← Codex 用的显示名和调用策略
├── references/
│   ├── style-dna.md              ← 风格 DNA:必须、颜色、绝对不要
│   ├── xiaohei-ip.md             ← 小黑是谁:外形、性格、动作、禁止
│   ├── composition-patterns.md   ← 8 种构图结构 + 原创隐喻生成法
│   ├── prompt-template.md        ← 单张生图提示词模板
│   └── qa-checklist.md           ← 生成后的检查清单
└── assets/examples/              ← 14 张示例图,只用于风格校准

SKILL.md 只有 106 行,5 份参考文档加起来不到 300 行。整个 Skill 13 MB,几乎全是示例图。

它的形状就是一份风格说明书:没有数据库,没有脚本,只有把一种审美讲清楚的文字。好用的 Skill 不一定要复杂。


四、精读:把一种画风拆成能执行的规则

1. 风格 DNA:颜色各有分工

本文是会员内容

全文 2,358 字,已试读约 30%。开通专业版可阅读全文,并解锁全部官方课程与后续更新。

开通专业版

支持 7 天无理由退款 · 早鸟价 99 元/年(售完恢复365/年)

课程中涉及的第三方项目,其著作权与商标归各自权利人所有;引用处的署名与许可见《开源与来源说明》。