baoyu-article-illustrator 适合为教程、方法说明和长文补充视觉解释。它会先分析文章结构，区分流程、比较、框架、时间线等信息类型，再决定在哪里放图；并非每段都需要一张装饰性图片。
安装与调用
在项目目录的终端运行下面的命令，只安装这个 Skill 到 Claude Code：
npx skills add jimliu/baoyu-skills --skill baoyu-article-illustrator -a claude-code
需要 Node.js 和可用的 npx。若使用 Codex，把 -a claude-code 换成 -a codex；在对话里明确要求使用 baoyu-article-illustrator 并附上材料，不把终端安装命令当成任务提示。其他客户端应使用自身的技能选择入口。
先确认图像后端能用
安装的是配图流程，实际出图仍需要当前客户端的图像工具。若使用独立 API 路径，可另按需安装 baoyu-image-gen，首次选择供应商、可用模型和保存配置。Google 路径需要自己的 API 凭据，仓库使用 GOOGLE_API_KEY；不要把密钥写进文章或提示词。没有后端时可以先完成配图计划，不能把它称为成图。
首次运行会建立 .baoyu-skills/baoyu-article-illustrator/EXTEND.md 等偏好，项目级配置优先。可以这样输入：
使用 baoyu-article-illustrator 为 handoff.md 配图。
读者是首次做项目交接的人，最多三张，只在流程或责任关系难理解的位置使用。
先给位置、目的、图中信息和类型；建议 minimal 风格与统一配色。
确认大纲与可用后端后生成，正文事实与数字保持原样。
每张图只承担清楚的解释任务
流程适合 flowchart，两种方案适合 comparison，层次或关系可以选 framework；风格与配色是另一组选择，不应为了好看破坏信息结构。检查隐喻是否真的解释文章，例如讨论工作流程的“瓶颈”应画约束关系，而不是只画一个瓶子。
确认后生成 outline.md 和每张独立的 prompts/NN-类型-主题.md，再调用后端。默认图片目录通常是文章旁的 imgs/，也可通过偏好修改。大纲应能让你知道每张图插在哪段后面、为什么需要以及预计说明哪些内容。
看成图时逐项核对数字、标签、箭头方向与比较关系，并在文章真实宽度下检查可读性。Google 的图像文档也建议先确定文字再生成画面，这与先审提示的流程一致。错字应修改提示后重新生成，或减少图中文字，不能只看整体画风就通过。
最后检查 Markdown 相对路径是否正确，以及实际成功图片数是否与大纲一致。局部重做时保留旧候选、更新对应提示文件，不必重跑已经正确的图；原文修改后也要检查插图是否仍在表达同一个版本的事实。
试着给一篇真正需要解释的文章配图
例如一篇介绍“需求从提交到上线”的教程，先圈出读者最容易混淆的两个位置：审批和实现是否串行、上线失败会回到哪一步。让 Agent 只为这两处提出图，而不是按段落数平均分配。第一张可用流程图画出责任人和返回路径，第二张用对比图说明正常发布与回滚；在大纲中逐图标注对应段落。读者即使跳过图片，也应能从正文读懂事实，配图负责缩短理解时间。
核对大纲时，可以先问：“如果去掉这张图，哪一种关系会更难理解？”答不出来就删掉。成图后把图中的每个标签与文章原句逐一对上；若责任人名称或流程方向错了，应先改提示文件，再只重做该图。若连大纲都出现文中没有的步骤，问题在内容分析阶段，不是图像后端，把它退回去重做。这样比直接换一种画风更能解决错误。
先统一整组插图的风格
想让一组配图看起来像同一篇文章，第一次就把整套约束写进请求：每张图对应哪一段、统一的线条与配色、每张最多承载一句短文案、目标比例。金尘马公开的做法是给 Claude Code 附上文章文件，让 baoyu-article-illustrator 按段构建 16:9 简笔画提示词；他没有配置生图 API，而是要求先把提示词存文件，再拿到外部工具生成。这个流程说明“提示词已生成”和“图片已生成”是两个验收点。先读提示词，确认图像解释了正文而非仅装饰，再检查实际成图中文字与画风是否一致。