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外部依赖
| 类型 | 依赖 |
|---|---|
| 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风险提醒 风险提醒：橙色 · 评估后使用
风险提醒：橙色 · 评估后使用
- 用户素材必然出网到外部生成后端 — 按 SKILL.md 执行时源文档内容与 prompt 会交给 Codex/baoyu-image-gen 等第三方图像模型（可能消耗账号额度）。敏感内容应在出图前自行删改，不能只依赖 SKILL.md 的『剥离凭证』要求（那是模型执行的软约束）。
- 下游后端可能带来红线级行为 — 当解析到 codex-imagegen/`baoyu-image-gen --provider codex-cli` 时，实际执行的是 `codex exec --sandbox danger-full-access`（该后端自身判红）；本 skill 不改档，但用户在无原生 imagegen 的运行时里使用它会继承该行为。
- 图像上的文字不可控 — 信息图文字由图像模型绘制，可能出现错字/漏字（SKILL.md 对此只给『改 prompt 重生成』与『换低文字密度布局』两条出路，禁止代码修补），批量出图时需要人眼验收。
- EXTEND.md 可静默改变后端与默认组合 — preferred_image_backend 等键由本地文件控制；若该文件被他人改写，agent 会在『默认值』名义下使用非预期后端。SKILL.md 只要求未找到时询问，找到即直接沿用。
风险提醒：橙色，评估后使用。三段自证：① 判级对象是本 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结论
适合：适合把长文/报告/课程内容转成一张自解释的高密度信息图（尤其 dense-modules + morandi-journal/pop-laboratory 这类『高密度信息大图』），也适合需要稳定视觉语言的自媒体/课件作者用 EXTEND.md 固定首选布局与风格。希望『先看方案再出图』的用户会喜欢它的硬确认门禁。
不适合：不适合要求像素级可控/可编程排版（应走图表库或 SVG 代码渲染，本 skill 明确禁止把代码渲染当替代品）；不适合无任何可用图像后端的环境（会停在询问）；不适合未经脱敏就要把机密文档送外部模型的场景；也不适合期望一次出图即成稿、不接受多轮重生成的批量生产。
安装 agent 直装可复制
① 本站镜像 更新 2026-09-15
方式 A · 人下载镜像包下载 baoyu-infographic.tar.gz
sha256:
方式 B · JSON 格式安装指南，复制给 agent68d6840b2ed27261…agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。
② 上游 GitHub · 原始来源
来源信息 GitHub 原始
作者 / 仓库JimLiu / JimLiu/baoyu-skills
原始 GitHubJimLiu/baoyu-skills ↗
Stars25926
最近推送2026-09-10
本 skill commit
1567581c26许可MIT（仓库根 LICENSE，Copyright (c) 2026 Jim Liu；GitHub API spdx_id=MIT）
本站信息
收录日期2026-09-06
分类设计
侦查报告AI 侦查 · 2 遍 · 2026-09-06
本站镜像与 GitHub 原始是不同来源：本站锁定 commit 快照经 /r2 分发；GitHub 为实时上游，内容可能已更新。