1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | ian-xiaohei-illustrations | — |
| 作者/维护者 | Ian（helloianneo，独立产品设计师） | GitHub API |
| 来源链接 | https://github.com/helloianneo/ian-xiaohei-illustrations | — |
| 许可证 | MIT License | GitHub API |
| GitHub Stars | 8,331 | GitHub API |
| Forks | 1,015 | GitHub API |
| 最新版本 | v1.0.0 | GitHub API |
| 安装方式 | git clone 后复制子目录到 Codex skills 目录 |
仓库 README |
仓库自述名称与正式名称一致，均为 ian-xiaohei-illustrations（GitHub 独立仓库，按仓库名机械确定）。
2. 功能介绍与亮点
这是一款专为中文文章、博客、Notion 文档设计正文配图的 Codex Skill。它不追求做通用商业插画或 PPT 信息图，而是先读懂文章里的核心判断、流程、结构或隐喻，挑出真正值得可视化的“认知锚点”，再把其中一个转化成一张有记忆点的 16:9 手绘解释图。
- 固定视觉 IP：默认使用“小黑”——黑色实心、白点眼、细腿、空表情的角色，且要求小黑必须参与画面核心动作，不能只是装饰，避免配图沦为好看但空洞的贴纸
- 先策略、后生图：可以只输出 4-8 张的 shot list（每张图的段落位置、主题、结构类型、标注建议），也可以直接一键生成成品 PNG，两种模式都支持
- 风格约束清晰：纯白背景、黑色手绘线稿、少量红橙蓝中文批注、大量留白，仓库自带
qa-checklist.md用于生成后自查，避免画面变成流程图或商业海报 - 零外部依赖：不调用任何第三方 API，直接使用宿主 Agent 内置的图像生成能力完成出图
3. 适用场景
固定分类：内容创作与知识管理
适合写中文文章、方法论内容、AI 工作流内容的创作者，尤其是希望配图有统一视觉识别度、又不想用传统 PPT 信息图的人。典型使用者包括个人博客作者、知识型内容创作者、Notion 文档撰写者，以及需要把抽象判断画成具体隐喻的产品/技术写作者。不适合需要商业插画、品牌视觉物料或严格可编辑矢量源文件的场景。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Codex | ✅ 原生支持 | 仓库明确标注“Codex Skill”，提供 agents/openai.yaml 配置，安装路径直接指向 $CODEX_HOME/.codex/skills |
| Claude Code | ⚠️ 需适配 | SKILL.md 采用通用 frontmatter 格式，结构上可迁移；但仓库文档与安装脚本均按 Codex 设计，社区已提交“Add Claude Code support”补丁（PR，截至抓取时仍未合并），需手动调整安装路径与出图方式 |
| OpenClaw | ❓ 未验证 | 已抓取材料中未出现相关说明 |
| Hermes Agent | ❓ 未验证 | 已抓取材料中未出现相关说明 |
5. 推荐理由
它把“给文章配图”从一件需要现场攒 prompt、风格漂移的苦差事，变成一套可复用的固定视觉语言：先自动圈出文章里真正值得画的判断点，再用统一的“小黑”角色和留白手绘风格出图，产出稳定不跑偏。对经常写中文长文、又不想每次重新设计配图风格的内容创作者来说，装上就能直接用，且完全不依赖第三方付费 API。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 9 | GitHub 8,331 星、1,015 Fork；仓库 Issue/PR 区有 19 位不同用户的真实提问与贡献，非单纯刷量 |
| 可用性 | 9 | SKILL.md、README、风格参考文档、QA 检查清单齐全且附示例图；git clone + 复制目录即可安装；近两个月内仍有提交与合并；不依赖任何付费第三方服务 |
| 安全性 | 9 | 纯 Markdown 提示词与参考文档，无脚本执行、无网络外发、无需任何凭据；MIT 协议明确；作者身份可查，非匿名账号 |
| 综合评分 | 9.0 | 三项均值 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令及权限范围 | 不涉及，仓库内无可执行脚本，仅 Markdown 文档 |
| ② 运行时联网外发 | 无，出图直接使用宿主 Agent 内置能力，不请求任何外部接口 |
| ③ API Key/凭据 | 不需要 |
| ④ 可疑指令 | 未发现 prompt injection 或隐藏指令迹象 |
| ⑤ 作者/组织信誉 | 独立产品设计师，个人网站与社交账号可查，非匿名；仓库互动记录显示真实用户参与 |
| ⑥ License | MIT，明确 |
| ⑦ 最近维护 | 最近一次提交约在近两个月内，仍在回应社区 Pull Request |
7. 跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与本技能的差异 |
|---|---|---|
| GPT-Image2-Skill（wuyoscar） | 面向 GPT Image 2 模型的通用提示词图库 + CLI 工具链，覆盖论文配图、UI 原型、游戏 HUD 等 12+ 类场景，风格开放可选 | 需要配置 GPT Image 2 API Key 才能出图，风格由使用者临场选择；本技能不需要任何 API Key，且固定单一“小黑”手绘风格，专注中文文章配图这一个场景 |
| napkin.ai | 商业 SaaS，将文字自动转换为示意图/信息图，面向演示与文档场景 | 需要网页端账号登录、生成结果偏结构化信息图；本技能直接嵌入 Codex 工作流命令行使用，产出偏“怪诞手绘插画”而非规整信息图，视觉识别度更强但不适合严肃商务场景 |
8. 用户评价
该技能目前在 GitHub 之外的第三方平台尚无具名用户评价可查。仓库自身的 Issue 区有较多真实用户互动：例如用户 wongshinwan55-oss 提交 Pull Request 请求支持自定义 IP 形象替换默认的“小黑”角色，用户 maruf-asterbyte 提出希望支持生成英文版插画，均获得作者关注。
9. 其他补充
作者已发布同系列的“中文手绘技术 PPT 页面图生成 Skill”（ian-handdrawn-ppt），可视为同一视觉语言在不同产出形态上的延伸；感兴趣的用户可一并关注。
10. 安装使用方式
git clone https://github.com/helloianneo/ian-xiaohei-illustrations.git
cd ian-xiaohei-illustrations
mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"
cp -R ./ian-xiaohei-illustrations "${CODEX_HOME:-$HOME/.codex}/skills/"安装后在 Codex 中直接调用：
Use $ian-xiaohei-illustrations 为这篇中文文章设计并生成 5 张小黑怪诞正文配图。无需重启，也无需额外配置密钥；首次使用建议先只要求输出 shot list，确认配图方向后再要求正式出图。
11. 注意事项
- 官方安装路径与文档均面向 Codex 设计，在 Claude Code 等其他 Agent 中使用需手动调整安装目录与出图调用方式
- 出图效果依赖宿主 Agent 自身的图像生成模型能力，社区反馈显示部分非原生模型出图效果不稳定
- 中文标注文字越短越稳定，AI 图像模型仍可能出现错字或多余标题，生成后需人工检查
- 该风格定位偏“怪诞手绘”，不适合需要正式商业插画或品牌视觉物料的场景