1实现原理 · 为什么它能做到

实现方式是纯 prompt 编排：SKILL.md 把配图拆成 Type（信息结构）× Style（渲染手法）× Palette（配色，可选覆盖）三个正交维度，再按维度组合拼出图像 prompt——skill 自身零可执行代码。

skills/baoyu-article-illustrator/SKILL.md

Analyze articles, identify illustration positions, generate images with Type × Style × Palette consistency.

三维可自由组合（`--type infographic --style vector-illustration --palette macaron`），也可用 preset 一次给全；Type 决定信息结构，Style 决定画法，Palette 覆盖 Style 默认色。

第一步是文章结构分析：定内容类型、配图目的、2-5 条核心论点与“哪些位置值得配图”，并硬性禁止把隐喻画成字面图。

skills/baoyu-article-illustrator/references/workflow.md

| Visual opportunities | Positions where illustrations add value |

同一文件把“隐喻 → 画底层概念而非字面”写成 CRITICAL：article 用“电锯切西瓜”举例时不许画电锯与西瓜，要可视化背后的概念。

生成前有一条不可跳过的落盘门禁：每张图的完整 prompt 必须先写成独立文件，作为可复现记录与换后端的依据。

skills/baoyu-article-illustrator/SKILL.md

⛔ **BLOCKING: Prompt files MUST be saved before ANY image generation.**

文件命名 NN-{type}-{slug}.md，含 YAML frontmatter（illustration_id/type/style/palette/references）；正文要求用类型模板并含 ZONES/LABELS/COLORS/STYLE/ASPECT 结构化段落，LABELS 必须引用文章真实数字与术语。

后端解析是显式优先级规则：当前请求点名 > EXTEND.md 的 preferred_image_backend > 自动选择（Codex imagegen > codex CLI 的 codex-imagegen > Cursor GenerateImage > 其它宿主原生工具 > 唯一已装后端 > 问用户）。

skills/baoyu-article-illustrator/SKILL.md

1. **Current-request override** — if the user names a specific backend in the current message, use it.

这是“skill 点名单一生成后端”的关键证据面：文中把 Codex `imagegen`、`baoyu-image-gen --provider codex-cli`、Cursor `GenerateImage`、Hermes `image_generate` 逐一写死为候选，运行时会真的把这些后端叫起来。

两条硬性禁用条款把“用代码凑图”这条路堵死：不许用 SVG/HTML/canvas 代替栅格生成，也不许用 ImageMagick/Pillow/OCR 等程序化覆盖去修补已生成位图上的文字。

skills/baoyu-article-illustrator/SKILL.md

**⛔ Never substitute SVG, HTML, canvas, or other code-based rendering for raster image generation.**

文本错了只能改 prompt 重新生成，或让用户从多个不完美候选里挑；后处理仅限裁切/缩放/压缩/格式转换等不改动文字与主体构图的动作。

生成阶段默认批处理：优先后端原生批量接口，其次宿主并行工具调用（默认 4 张一批），最后才串行；失败项只重试一次且不重生成已成功项。

skills/baoyu-article-illustrator/SKILL.md

dispatch up to `generation_batch_size` images at a time. Default: `4`.

同一段还禁止“为了并行而派 subagent 渲染”，subagent 只用于 prompt 迭代或创意探索。

确认门禁默认开启：显式调用 skill、给文件路径、命中 preset、EXTEND.md 默认值都只算“推荐输入”，在用户完成设置确认前不得进入生成步骤。

skills/baoyu-article-illustrator/SKILL.md

Default behavior: **confirm before generation**.

只有当前请求明说“直接生成/不用确认/跳过确认/按默认出图”才可跳过，且跳过时必须在下一轮面向用户的更新里声明假设的 type/density/style/palette/language/backend。

首选项 EXTEND.md 走三级查找（项目 > XDG > 用户 home），找不到即阻塞并跑首次设置；输出目录由 default_output_dir 决定，最后把图片按相对路径回插文章。

skills/baoyu-article-illustrator/SKILL.md

Insert `![description]({relative-path}/NN-{type}-{slug}.png)` after paragraphs.

辅助文件（outline.md、prompts/）与图片同放输出目录；文章是粘贴内容时固定落到 illustrations/{topic-slug}/ 并另存 source-{slug}。

2核心能力

01文章结构分析与配图位置识别（内容类型 / 目的 / 核心论点 / 视觉机会）

02类型模板化 prompt 构造（infographic/scene/flowchart/comparison/framework/timeline 各有模板）

03Palette 覆盖 Style 默认配色（读 palettes/<palette>.md，颜色替换、保留 style 的纹理描述）

04参考图三态用法 direct/style/palette：direct 走 --ref，style/palette 抽特征写进 prompt 正文

05跨运行时后端解析（Codex imagegen / codex CLI / Cursor / Hermes / baoyu-image-gen）

06批量并行生成 + 单次重试 + 输出备份改名（-backup-YYYYMMDD-HHMMSS）

07偏好持久化与首次设置（EXTEND.md 三级查找，未找到即阻塞）

08文章回插与产物自检（outline.md/prompts/图片三层结构 + 每张图生成进度回报）

3外部依赖

Kind	Dependency / Endpoint
cli	codex CLI（codex-imagegen 分支）
cli	baoyu-image-gen skill（--provider codex-cli，首选路径）
api	Codex 原生 imagegen skill（Skill 工具调用）
api	Cursor 原生 GenerateImage 工具
network	codex-imagegen wrapper（自述：认证走用户 Codex 订阅，不读 OPENAI_API_KEY）

4管控建议与判定依据

建议配套管控措施

面向 Agent

分级或逐次授权，建议在沙箱运行

面向管理者

审批流程、可回滚、全程审计

判定依据（文件路径与关键语句摘要）

本地工作目录: 文件读写与工件输出: 依 SKILL.md 指令由 agent 写盘：outline.md、prompts/NN-{type}-{slug}.md、生成的图片、EXTEND
SKILL.md: 声明调用宿主 CLI 解释器或外部运行环境

审计说明： 。(a) SKILL.md 点名的运行时代理不是本地动作，而是外部生成后端：'**Codex (`imagegen`)** — first, inspect your available-skills / tool inventory.' 与 'route through `baoyu-image-gen --provider codex-cli` (preferred)'，并列出 Cursor `GenerateImage`、Hermes `image_generate` 同规则——照 SKILL.md 执行后，用户文章素材与拼好的 prompt 必然出网到第三方图像模型，且消耗用户账号额度（Codex 订阅或所装 provider）。(b) 同时有本地写盘：prompts/（硬门禁要求先落盘）、outline.md、生成的图片、EXTEND.md。(c) 自身目录零脚本、零自带网络端点、零凭证读取——出网与凭证面完全落在被点名的后端/宿主，故不判 red。对照先例：ai-image-generation / nano-banana-2 等“把素材送生成后端”一律 orange。

5第二遍独立确认

[ok] 自身目录无脚本/无网络端点/无凭证读取 — 目录内无任何可执行文件；全目录 URL 扫描只命中 github.com/JimLiu/baoyu-skills（frontmatter homepage），无请求端点、无 key/cookie/token 读取。
[ok] SKILL.md 确实点名单一外部生成后端（orange 档依据） — 'Codex (`imagegen`)'、'route through `baoyu-image-gen --provider codex-cli` (preferred)'、Cursor `GenerateImage`、Hermes `image_generate` 四处均在 SKILL.md 正文，且被写成生成前的必经步骤（Do this once per session before any generation）。
[ok] prompt 文件必须先落盘（BLOCKING） — SKILL.md Step 5 与 workflow.md 5.1 两处都写死；workflow.md 另有 Prompt Files 清单确认步骤。
[ok] 禁用 SVG / 禁用位图涂改两条禁令 — SKILL.md 与 workflow 均含；Modification 段重申后处理仅限 crop/resize/compression/format conversion。
[ok] 三维度与 preset 机制 — SKILL.md Three Dimensions 表 + 'Combine freely: `--type infographic --style vector-illustration --palette macaron`' + style-presets.md 均存在，无夸大。
[ok] references 数量与按需加载 — 36 个 styles/*.md + 4 个 palettes/*.md + workflow/prompt-construction/styles/style-presets/usage/config/codex-imagegen 均在盘中；codex-imagegen.md 自述只在该分支被选中时加载。
[ok] meta 元数据（license/stars/commit） — GitHub API：MIT、stargazers 25926、pushed_at 2026-09-10T15:13:43Z；本地镜像 HEAD 1567581c26ec29f4216c6e6835415bf30343b0e3 与任务 pin 一致；仓库根 LICENSE=MIT (c) 2026 Jim Liu。

6结论

维度化 + preset：把“配什么图”拆成可组合的三个正交参数，减少反复试错，也让批量风格统一。

可复现性被工程化：prompt 先落盘、文件名与 outline 一一对应，换后端/重生成都不丢历史。

质量纪律明确：不许拿代码凑图、不许在成品上涂字，逼模型用“改 prompt 重新生成”解决文本问题。

大批量可用：默认 4 张并行、失败只重试一次、已成功项不重跑，长文配图（6+ 张）成本可控。

跨宿主可搬运：同一份后端解析规则内联进 SKILL.md，Codex/Cursor/Hermes/裸 CLI 都能落到可用后端。

适合： 适合写长文/教程/方法论的作者按章节批量配图，也适合需要统一视觉语言的系列文章（preset + palette 锁定风格）；在 Codex/Cursor 里可直接用运行时原生图像工具，无需额外配置。

不适合： 不适合要求图像完全离线生成或严禁内容出网的场景；不适合需要矢量/可编辑图（应改用 baoyu-diagram 或设计工具）；不适合只想“随手插一张装饰图”的低要求场景——本 skill 有确认门禁与 prompt 落盘流程，开销明显。

Install Agent-Ready

① Verified Mirror 2026-09-15

Option A · Direct DownloadDownload baoyu-article-illustrator.tar.gz

sha256: 842c4e88785ed928…

Option B · Copy Guide for Agent

install.json

agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。

② Upstream GitHub

GitHub Repo ↗

Pinned to commit 1567581c26.