ian-xiaohei-illustrations

环境要求

• 已安装 git，可执行 git clone
• 已安装 Codex（需要 skills 目录，默认位于 $HOME/.codex/skills）
• 准备一篇中文文章或帖子作为配图素材
• 可写入本地用户目录的权限

安装与启动步骤

1. 1克隆仓库

   把 Ian Xiaohei Illustrations 仓库下载到本地，并进入仓库目录。

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

   复制

2. 2复制到skills目录

   在 Codex skills 目录下创建文件夹，并把整个 skill 目录复制进去；未设置 CODEX_HOME 时默认用 $HOME/.codex。

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

   复制

3. 3在 Codex 中调用

   在 Codex 会话里用 $ian-xiaohei-illustrations 唤起该 skill，并说明要为哪篇文章生成几张配图。

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

   复制

4. 4查看生成结果

   skill 会先给出 4-8 张 shot list（主题、结构、小黑动作、中文标注），再产出 PNG，保存到 workspace 的 assets/<article-slug>-illustrations/ 目录。

关键配置

如何确认成功

复制完成后在 Codex 中执行 Use $ian-xiaohei-illustrations …，能返回 4-8 张 shot list 并在 assets/<article-slug>-illustrations/ 看到生成的 PNG。

常见问题

注意事项

• 该 skill 面向中文内容配图，不适合商业插画、品牌 KV、PPT 信息图或儿童卡通风格。
• 每张图只表达一个核心动作、结构、状态或隐喻，不要把大段正文塞进一张图。
• 视觉固定为纯白背景、黑色手绘细线、大量留白（主体约 40%-60%）和少量红橙蓝中文批注。
• 安装命令只依据 README 提供的 clone 与 copy 步骤，未涉及任何模型权重或 API 密钥配置。