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

本目录零脚本、零可执行代码，全部能力由 SKILL.md 的流程指令 + references/ 里的模板与知识库构成——是『提示词工程 + 参考资料库』型 skill。

skills/baoyu-infographic/SKILL.md

Two dimensions: **layout** (information structure) × **style** (visual aesthetics). Freely combine any layout with any style.

目录内容只有 SKILL.md 与 references/（21 个 layouts、22 个 styles、base-prompt、analysis-framework、structured-content-template、config 两件、codex-imagegen 说明），没有任何 .ts/.js/.sh。

推荐算法是可执行的选择规则：命中关键词快捷方式时跳过内容推断、直接用映射的布局；否则按数据结构/语气/受众推荐 3-5 个 layout×style 组合。

skills/baoyu-infographic/SKILL.md

Skip content-based layout inference for matched keywords.

Step 3 的 3.1/3.2 两分支；SKILL.md 里另有一张推荐组合表（Timeline→linear-progression+craft-handmade 等）作为兜底知识。

有硬确认门禁：Step 4 必须由用户确认组合/比例/语言/后端，默认不允许 agent 直接开画。

skills/baoyu-infographic/SKILL.md

**Hard gate**: this step is mandatory per the [Confirmation Policy](#confirmation-policy)

Confirmation Policy 段把『显式调用 skill、给了路径、命中关键词、EXTEND.md 默认值』一律定义为 recommendation inputs only，不构成跳过确认的授权；只有 --no-confirm/『直接生成』等显式措辞才可跳过，且跳过时要在下一条用户可见消息里声明假设值。

图像后端在运行时解析（原生 imagegen > codex CLI > Cursor 原生 > 其他原生 > 唯一非原生后端），并点名了 baoyu-image-gen 这条具体路径。

skills/baoyu-infographic/SKILL.md

route through `baoyu-image-gen --provider codex-cli` (preferred)

这里在做什么：把『谁负责出像素』交给宿主能力探测，但把可选的第三方 skill 路径写死到命令级；这也是本 skill 的对外依赖面来源（用户内容与 prompt 会出网到第三方图像模型）。

提示词文件是强制产物：任何后端调用之前必须把完整 prompt 落到 prompts/NN-{type}-[slug].md，作为可复现记录。

skills/baoyu-infographic/SKILL.md

**Prompt file requirement (hard)**: write each image's full, final prompt to a standalone file under `prompts/` (naming: `NN-{type}-[slug].md`) BEFORE invoking any backend.

Step 5 把 layout 定义 + style 定义 + base-prompt 模板 + Step 2 结构化内容 + 语言合成 prompt；换后端不需要重写 prompt。

内容保真是硬规则：只搬运不概括，且出图前必须剥离凭证类信息；分析阶段用教学设计框架（学习目标、认知负荷、数据完整性）。

skills/baoyu-infographic/SKILL.md

**strip any credentials, API keys, tokens, or secrets** before including in outputs

同段核心原则：`Preserve source data faithfully—no summarization or rephrasing`；references/analysis-framework.md 进一步给出 9 类内容→布局/风格映射与『Data Integrity: Never alter, summarize, or paraphrase source facts』。

模板是占位符化的：base-prompt.md 用 {{LAYOUT}}/{{STYLE}}/{{ASPECT_RATIO}}/{{LANGUAGE}}/{{LAYOUT_GUIDELINES}}/{{STYLE_GUIDELINES}}/{{CONTENT}}/{{TEXT_LABELS}} 组装最终 prompt。

skills/baoyu-infographic/references/base-prompt.md

- **Layout**: {{LAYOUT}}

同一模板里带 Image Specifications / Core Principles / Text Requirements 三段约束，以及 `Generate the infographic based on the content below:` 与 Text labels 段。

产物与备份纪律明确：固定目录结构 infographic/{topic-slug}/，同名文件按时间戳备份，冲突时追加时间后缀。

skills/baoyu-infographic/SKILL.md

infographic/{topic-slug}/

Output Structure 段列出 source-{slug}.{ext} / analysis.md / structured-content.md / prompts/infographic.md / infographic.png；Step 1.2、Step 5、Step 6 各自规定备份重命名规则（如 `analysis-backup-YYYYMMDD-HHMMSS.md`）。

两条硬性『不许作弊』规则：不许用 SVG/HTML/canvas 代码渲染冒充栅格图，不许用代码在已生成位图上涂抹修字。

skills/baoyu-infographic/SKILL.md

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

第二条：`**⛔ Never repair rendered text by painting over a generated bitmap.**`——要求改 prompt 重生成或换布局，而不是贴图修补；后处理只允许裁切/缩放/压缩/转格式。

2核心能力

0121 种布局 × 22 种风格的正交组合（默认 bento-grid + craft-handmade）

02关键词快捷方式（如高密度信息大图 → dense-modules + portrait）

03内容分析 → structured-content.md（标题/学习目标/小节/视觉元素/文本标签/数据点逐字保留）

04运行时图像后端解析与降级链（Codex imagegen / codex-imagegen / Cursor GenerateImage / 其他原生 / 唯一非原生）

05参考图三种用法（direct 直接传后端 / style 抽风格特征 / palette 抽 hex 色）并记入 prompt frontmatter

06硬确认门禁与显式跳过（--no-confirm / 『直接生成』），跳过时必须声明假设值

07EXTEND.md 偏好（首选后端/布局/风格/比例/语言/自定义风格）与首次配置流程

3外部依赖

Kind	Dependency / Endpoint
api	baoyu-image-gen（第三方 skill，--provider codex-cli 路径；会读该 skill 自己的 provider 凭据）
cli	Codex CLI（codex login 订阅态、codex exec）
api	Codex 运行时原生 imagegen skill（经由 Skill 工具调用）
api	Cursor 原生 GenerateImage 工具（无比例参数、无输出目录）
package	bundled codex-imagegen 包装脚本（免装 baoyu-image-gen 时的直调路径；其自身会 spawn codex，用 Codex 订阅而非 API key）
cli	bun（运行包装脚本；缺 bun 时 npx -y bun）

4管控建议与判定依据

建议配套管控措施

面向 Agent

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

面向管理者

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

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

scripts/: 执行本地脚本或命令: 本目录无自带脚本可执行；SKILL.md 指示 agent 调用图像后端：运行时原生 imagegen / Cursor GenerateImage
网络端点: 声明外部网络访问: 由所解析到的图像后端发起（Codex imagegen / codex exec 走 Codex 服务；baoyu-image-gen 走其选定的第三
本地工作目录: 文件读写与工件输出: infographic/{topic-slug}/：source-{slug}.{ext}、analysis.md、structured-conten

审计说明： 。三段自证：① 判级对象是本 skill 目录（SKILL.md + references/，无脚本无端点无 fetch）；② 目录内自身行为＝本地写盘（infographic/{topic-slug}/ 下的 source/analysis/structured-content/prompts/png + 时间戳备份）；③ 判橙的关键＝SKILL.md 点名为自身用途调用的外部生成后端：`route through `baoyu-image-gen --provider codex-cli` (preferred)`（另点名 Codex 原生 `imagegen`、Cursor `GenerateImage`、bundled codex-imagegen），按批4 口径『把用户素材/prompt 送去外部生成后端（含消耗账号额度、素材出网）→ orange』；凭据由后端持有、本 skill 不读密钥，故不因凭据升级；无逆向/冒充/绕过/安全降级（详情页须注意：所选后端若为 baoyu-image-gen 的 codex-cli 分支，其内部使用 codex exec --sandbox danger-full-access，属后端自身的红线，本 skill 不改档但已在 verdict.risks 标注）。

5第二遍独立确认

[ok] 『21 布局 + 22 风格』数量属实 — references/layouts/ 实际 21 个 .md（linear-progression…dense-modules），references/styles/ 实际 22 个 .md（craft-handmade…retro-popup-pop）；SKILL.md 两张 Gallery 表逐项对应。
[ok] 本目录无脚本/无端点/无凭证 — 目录内文件全为 .md；token 扫描 fetch/http/spawn/exec/process.env/API_KEY 零命中。
[ok] 点名的外部生成后端（判橙依据） — SKILL.md Image Generation Tools 段逐条给出 Codex imagegen、codex-imagegen（含 `baoyu-image-gen --provider codex-cli` 首选路径）、Cursor GenerateImage、其他原生工具；references/codex-imagegen.md 进一步给出直调包装脚本的命令与 'no OPENAI_API_KEY is read or sent' 说明。
[ok] 确认门禁为硬门禁而非建议 — SKILL.md 'Hard gate: this step is mandatory…' 与 Confirmation Policy 段把显式调用/关键词/EXTEND.md 默认值一律降级为 recommendation inputs；Step 6 亦注明必须先落 prompt 文件。
[ok] 内容保真与脱敏要求 — SKILL.md Core Principles 原文 'Preserve source data faithfully—no summarization or rephrasing' 与 '**strip any credentials, API keys, tokens, or secrets** before including in outputs'；Step 2 Rules 重申。
[ok] 反作弊条款（禁 SVG 替代 / 禁位图涂改） — 两段 ⛔ 文本均在 SKILL.md，且 Text correction policy 段限定后处理只能做裁切/缩放/压缩/转格式。
[discrepancy] references 里 styles 定义的数量在 SKILL.md 自身文本中有笔误 — SKILL.md 末尾 References 列表写 'references/styles/<style>.md - 21 style definitions'，但 Style Gallery 与目录实际均为 22 个（frontmatter 描述也写 '22 visual styles'）。结论以目录/表格为准＝22；此为文档小笔误，不影响判级。
[ok] codex-imagegen 直调路径可能导致下游红档行为 — 本 skill 的 references/codex-imagegen.md 指示在无 baoyu-image-gen 时直调 bundled 包装脚本，而该包装脚本（skills/baoyu-image-gen/scripts/codex-imagegen/spawn.ts）以 codex exec --sandbox danger-full-access 运行——红线属被调后端，改写为本 skill 的判级不成立，但已写进 verdict.risks 供用户知情。

6结论

把信息图拆成『结构（布局）× 审美（风格）』两个正交维度并给出 21×22 份可拼装定义，组合自由度远高于固定模板类工具。

确认门禁挡住『agent 自作主张出图』：默认必须用户确认组合/比例/语言/后端，且把各种隐式信号显式降级为推荐。

可复现与可切换后端：prompt 先落盘为文件，后端解析链支持 Codex/Cursor/原生/第三方 skill 多条路径，换后端不必重写 prompt。

内容保真 + 脱敏 + 反作弊三件纪律齐全，直面『信息图最容易失真的地方』（数据被改写、密钥随 prompt 外发、用代码假造图或涂改文字）。

内容分析方法论（9 类内容→布局/风格映射 + 学习目标 + 认知负荷）让推荐有据可依，而不是凭风格词猜。

适合： 适合把长文/报告/课程内容转成一张自解释的高密度信息图（尤其 dense-modules + morandi-journal/pop-laboratory 这类『高密度信息大图』），也适合需要稳定视觉语言的自媒体/课件作者用 EXTEND.md 固定首选布局与风格。希望『先看方案再出图』的用户会喜欢它的硬确认门禁。

不适合： 不适合要求像素级可控/可编程排版（应走图表库或 SVG 代码渲染，本 skill 明确禁止把代码渲染当替代品）；不适合无任何可用图像后端的环境（会停在询问）；不适合未经脱敏就要把机密文档送外部模型的场景；也不适合期望一次出图即成稿、不接受多轮重生成的批量生产。

Install Agent-Ready

① Verified Mirror 2026-09-15

Option A · Direct DownloadDownload baoyu-infographic.tar.gz

sha256: 68d6840b2ed27261…

Option B · Copy Guide for Agent

install.json

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

② Upstream GitHub

GitHub Repo ↗

Pinned to commit 1567581c26.