菜单
生成墨筝风格的小黑正文配图。用于用户要求为中文文章、帖子、博客、工作流文档、方法论、流程、结构、状态、隐喻或观点生成”怪诞””小黑””手绘””正文配图””文章插图””配图建议””shot list””去标题/改图”等任务；默认使用小黑 IP、纯白手绘、筝弦金为主强调色、简洁清爽但天马行空的视觉风格。
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/NealST/blog-source --skill xiaohei-illustrations命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
正在显示 SKILL.md
基于 SOC 职业分类
| name | xiaohei-illustrations |
| description | 生成墨筝风格的小黑正文配图。用于用户要求为中文文章、帖子、博客、工作流文档、方法论、流程、结构、状态、隐喻或观点生成”怪诞””小黑””手绘””正文配图””文章插图””配图建议””shot list””去标题/改图”等任务；默认使用小黑 IP、纯白手绘、筝弦金为主强调色、简洁清爽但天马行空的视觉风格。 |
为中文文章设计和生成 16:9 横版正文配图。目标不是做商业插画、PPT 信息图或可爱卡通，而是把文章里的关键判断、流程、结构、状态或隐喻，变成一张清爽、怪诞、有创意、可读但不说明书的手绘解释图。
默认视觉 IP 是“小黑”：黑色实心、白点眼、细腿、空表情，认真做一件荒诞但成立的事。小黑必须参与画面的核心动作，不能只是站在旁边当装饰。
按任务需要读取，不要一次塞满上下文：
references/style-dna.md：风格 DNA、颜色、文字、禁忌。references/xiaohei-ip.md：小黑 IP 的形象、性格、动作库和禁忌。references/composition-patterns.md：结构类型、原创隐喻方法和反复刻规则。references/prompt-template.md：单张生图提示词模板。references/qa-checklist.md：生成后检查和迭代规则。assets/examples/：只作低频视觉校准，不进入默认生成路径。不要照抄这些案例的构图、物件或标注。先读用户给的正文、链接、Notion 页面、Markdown 文件或截图内容。提炼：
不要平均配图。优先选择“认知锚点”，例如：核心判断、两个断点、输入输出闭环、分流、前后对比、一鱼多吃、承接路径、常见坑、角色状态变化。
如果用户只是说“分析怎么配图 / 思考哪些地方需要配图”，先给 shot list。每张图写清楚：
默认 4-8 张。文章很短时 1-3 张；长文也不要轻易超过 9 张。够用就好，避免把正文做成画册。
如果用户明确要求”生成 / 输出 / 做图 / 帮我生成”，不要停下来等确认；按 references/prompt-template.md 模板填充提示词，调用 TopView API 生图脚本逐张生成。不要把多张图拼在一张里。
生成方式：使用 content-pipeline 的 topview_image_gen.py 脚本调用 TopView AI API（GPT Image 2 模型，16:9，2K 分辨率）。
# 单张
python3 “${CONTENT_PIPELINE_DIR}/scripts/topview_image_gen.py” \
--prompt “<填充后的完整提示词>” \
--output “content/<slug>/xiaohei-illustrations/01-topic-name.png”
# 批量（先将 shot list 的 prompt 写入 JSON）
python3 “${CONTENT_PIPELINE_DIR}/scripts/topview_image_gen.py” \
--batch shot-list.json \
--output-dir “content/<slug>/xiaohei-illustrations/”
batch JSON 格式：
[
{“filename”: “01-topic-name.png”, “prompt”: “Generate one standalone 16:9 ...”},
{“filename”: “02-topic-name.png”, “prompt”: “...”}
]
每张图只讲一个核心结构。提示词必须包含：
不要复刻过往案例。案例只提供风格密度和小黑参与方式，不能直接复用”传送带断点 / 小黑拉线 / 素材鱼 / 盖章工具箱 / 常见坑路径”等已有构图，除非用户明确要求复刻某张图。每次都要从当前文章重新发明一个奇怪但成立的隐喻。
生成后检查 references/qa-checklist.md。如果出现以下问题，优先重生成或局部编辑：
配图直接生成到 content-pipeline 的产物目录：
content/<slug>/xiaohei-illustrations/
按顺序命名：
01-topic-name.png
02-topic-name.png
保留原始生成文件，不要覆盖已有资产，除非用户明确要求替换。
生图依赖 TopView AI API，需要设置：
export TOPVIEW_API_KEY='your-api-key'
export TOPVIEW_UID='your-user-id'
脚本位置：content-pipeline/scripts/topview_image_gen.py（与 content-pipeline skill 共享）。
生成前的策略输出要短而准。生成后的交付要包含：
不要长篇解释风格理论；让图自己说话。