ian-xiaohei-illustrations README

The project's README from github.com/helloianneo/ian-xiaohei-illustrations. As one markdown file: README.md.

Ian Xiaohei Illustrations

把中文文章里的判断、流程、状态和隐喻,变成一张张白底、手绘、怪诞但清爽的正文配图。

16:9 横版 | 小黑 IP | 纯白手绘 | 少量红橙蓝中文批注 | Codex Skill


这个仓库是什么

Ian Xiaohei Illustrations 是一个 Codex Skill,用来指导 AI Agent 为中文文章、帖子、博客、Notion 文档和方法论内容生成正文配图。

它不是通用插画 prompt,也不是 PPT 信息图模板。它的核心目标是:先理解文章里的认知锚点,再把其中一个判断、流程、结构、状态或隐喻,变成一张有记忆点的 16:9 手绘解释图。

默认视觉 IP 是“小黑”:一个黑色实心、白点眼、细腿、空表情的小角色。小黑不是吉祥物,不是贴纸,也不是站在角落里的装饰物,而是正在认真参与系统运转的荒诞工作者。

一句话:让 AI 不只是“配一张图”,而是把文章里的一个关键认知动作画出来。


适合谁用

特别适合:

不适合:


它会产出什么

默认输出:

默认不输出:


视觉风格

这个 skill 默认使用 Ian 的“小黑怪诞正文配图”风格:


示例效果

两个断点

两个断点

按目的分拣

按目的分拣

一鱼多吃

一鱼多吃

承接路径

承接路径

信息井

信息井

想法压机

想法压机

内容发酵

内容发酵

信任桥

信任桥

这些图片是风格校准样例,不是构图模板。使用时应该从当前文章重新发明隐喻,不要照抄旧案例的物件和构图。


安装

克隆仓库:

git clone https://github.com/helloianneo/ian-xiaohei-illustrations.git
cd ian-xiaohei-illustrations

复制 skill 到 Codex skills 目录:

mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"
cp -R ./ian-xiaohei-illustrations "${CODEX_HOME:-$HOME/.codex}/skills/"

安装后,在 Codex 里使用:

Use $ian-xiaohei-illustrations 为这篇中文文章设计并生成 5 张小黑怪诞正文配图。

怎么用

只做配图规划

Use $ian-xiaohei-illustrations 先不要生图。
请分析下面这篇文章哪里值得配图,输出 5 张左右的 shot list。
每张图写清楚:放在哪段后、主题、核心意思、结构类型、小黑在做什么、建议中文标注词。

<粘贴文章>

直接生成正文配图

Use $ian-xiaohei-illustrations 把下面这篇文章生成 4 张小黑怪诞正文配图。
要求:16:9 横版、纯白背景、黑色手绘线稿、少量红橙蓝中文手写批注。

<粘贴文章>

为单个概念生成一张图

Use $ian-xiaohei-illustrations 为“信任不是喊出来的,而是一块证据一块证据铺过去”生成一张正文配图。
画面要怪诞但清爽,小黑必须承担核心动作。

去掉图里的标题或错误文字

Use $ian-xiaohei-illustrations 帮我编辑这张图,去掉左上角的“流程图”标题,其他内容保持不变。

更多示例见 examples/prompts.md。


工作流程

这个 skill 的流程是:

  1. 读取文章、Markdown、Notion 内容、截图或用户给的主题
  2. 提炼核心观点、认知转折、流程结构和适合视觉化的段落
  3. 先输出 shot list:每张图只选一个认知锚点
  4. 为每张图选择结构类型:Workflow、系统局部、前后对比、角色状态、概念隐喻、方法分层、地图路线或小漫画分镜
  5. 重新发明一个低科技、怪诞但成立的物理隐喻
  6. 让小黑承担核心动作
  7. 每张图单独调用图像模型生成
  8. 按 QA checklist 检查:白底、留白、小黑动作、中文标注、非 PPT 感、非旧案例复刻
  9. 保存最终 PNG,并报告用途和路径

目录结构

.
├── README.md
├── LICENSE
├── NOTICE.md
├── assets/
│   └── ian-wechat-qr.jpg
├── examples/
│   ├── images/
│   │   ├── 01-two-breakpoints.png
│   │   ├── 02-sort-by-purpose.png
│   │   └── ...
│   └── prompts.md
└── ian-xiaohei-illustrations/
    ├── SKILL.md
    ├── agents/
    │   └── openai.yaml
    ├── assets/
    │   └── examples/
    └── references/
        ├── style-dna.md
        ├── xiaohei-ip.md
        ├── composition-patterns.md
        ├── prompt-template.md
        └── qa-checklist.md

真正需要安装到 Codex 的是子目录:

ian-xiaohei-illustrations/

根目录的 README、LICENSE、NOTICE 和 examples 是 GitHub 分享文档。


注意事项


相关项目


关于作者

Ian (伊恩) — 产品设计师 / 一人公司实践者 / AI Builder

用 AI 团队打造一人公司。


继续探索

这套小黑配图 Skill,只是我用 AI 搭建个人生产系统里的一个小工具。

如果你也在用 AI 做内容、知识库、工作流或产品化,可以继续看我的网站:www.ianneo.xyz。

只想先观察,可以关注我的 X/Twitter。

想了解 Indie Builders Club,加微信:ianneoxyz,备注「OPC」。

Ian 微信二维码

不方便扫码也可以搜索微信:ianneoxyz。


License

MIT License. See LICENSE.

ian-xiaohei-illustrations (helloianneo/ian-xiaohei-illustrations)

art
Searching Database…

What is this?A Codex Skill that guides an AI agent to generate body-text illustrations for Chinese articles, blog posts, and Notion docs, turning a judgment, process, or metaphor from the text into a 16:9 white-background hand-drawn image featuring the 'Xiaohei' character.
Is this a generic illustration prompt template, or something more structured?It is neither a generic illustration prompt nor a PPT-style infographic template; it is a structured skill that first extracts a cognitive anchor from the article and reinvents it as a specific low-tech visual metaphor.
How do I install and use this with Codex?Clone the repository, then copy the skill subdirectory into your Codex skills directory; once installed you invoke it directly from inside Codex.
Do I need an image generation model to use this?Yes — the skill only plans a shot list and prompts; it calls an AI image model separately for each of the 4-8 illustrations it produces per article.
Does the generated Chinese text in the images always come out correct?No, the underlying image model can introduce typos, hallucinated labels, style drift, or extra titles, so every output needs manual review, and shorter Chinese captions are recommended for stability.
Who is this skill actually built for?It suits people writing Chinese knowledge or methodology content who want a distinctive, low-key hand-drawn illustration style; it is not meant for commercial illustration, brand key visuals, PPT infographics, or cute mascot/sticker styles.
What role does the Xiaohei character play in each image?Xiaohei must be actively performing the core action of the illustration — if removing the character would leave the image's meaning unchanged, the skill considers it too decorative and wrong.
What file formats does it refuse to output?It deliberately avoids PPTX, PDF, Keynote, SVG, HTML, and Canvas-editable formats; it only ever produces final flattened PNG images saved into a workspace assets folder.
How many images does it generate per article?Typically 4 to 8 illustrations per article, each covering one distinct cognitive anchor such as a judgment, process, state, or metaphor, defined through a shot list before any image is generated.
What is the default visual style it enforces?Pure white background with no paper texture or gradients, thin slightly shaky black line art, large negative space with the subject covering only 40-60% of the frame, and sparse red, orange, or blue Chinese handwritten annotations.
Size
12.9 MB
Stars
12.6K
Age
4mo
Commits · 90 Days