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)

Searching Database…

12.6K ·GitHub
Ian-xiaohei-illustrations
这是什么？一个 Codex Skill，用于指导 AI 智能体为中文文章、博客文章和 Notion 文档生成正文插图。它会把文中的一个判断、流程或比喻，转化为一张 16:9、白底手绘风格、以「小黑」为角色的图片。
这是通用的插图提示词模板，还是更有结构的东西？它既不是通用插图提示词，也不是 PPT 风格的信息图模板；它是一个结构化的技能，先从文章中提炼出一个认知锚点，再将其重新构思为一个具体、朴素的视觉比喻。
如何在 Codex 中安装和使用它？克隆仓库，然后将技能子目录复制到你的 Codex Skills 目录中；安装后，直接在 Codex 内部调用即可。
使用它需要图像生成模型吗？需要。该技能只负责规划分镜清单和提示词；对于每篇文章产出的 4 到 8 张插图，它会分别单独调用一次 AI 图像模型。
生成图片中的中文文字总是正确的吗？不一定。底层图像模型可能出现错别字、凭空编造的标签、风格漂移或多余的标题，因此每个输出都需要人工检查；为了更稳定，建议使用较短的中文说明文字。
这个技能究竟是为谁打造的？它适合撰写中文知识类或方法论内容、并希望获得独特低调手绘插图风格的人；它不适用于商业插画、品牌主视觉、PPT 信息图，也不适用于可爱的吉祥物或贴纸风格。
小黑在每张图中扮演什么角色？小黑必须主动执行插图的核心动作。如果去掉这个角色，图片的含义不会改变，那么该技能会认为它过于装饰，属于错误做法。
它拒绝输出哪些文件格式？它刻意避开 PPTX、PDF、Keynote、SVG、HTML 以及 Canvas 可编辑格式；它只输出最终拍平的 PNG 图片，并保存到工作区的 assets 文件夹中。
它每篇文章会生成多少张图？通常每篇文章生成 4 到 8 张插图，每张对应一个不同的认知锚点，例如一个判断、流程、状态或比喻；在生成任何图片之前，都会先通过分镜清单来确定这些锚点。
它默认强制执行的视觉风格是什么？纯白背景，不带纸张纹理或渐变；线条纤细、略带抖动的黑色线稿；大面积留白，主体只占画面的 40%-60%；并配以少量红色、橙色或蓝色的中文手写注释。
What are similar projects?gathered-scenes-zine-skill, handraw-style, photo-abstract-editorial, kid-papercraft, muyang-illustration-skills, reference-video-director, travel-memory-sticker-card, ip-as-logo-skill
Which topics is it in?illustration, aigc, ai-art, art, prompt, codex-skill, chinese-language, ai-tools, content-creation, agent-skill, image-generation, design
Creator
helloianneo
Size
12.9 MB
Stars
12.6K
Updated
CommitSep 24Releasev1.0.0May 27
Age
4mo
Commits · 90 Days