{/* This page is auto-generated from the skill's SKILL.md by website/scripts/generate-skill-docs.py. Edit the source SKILL.md, not this page. */}

Baoyu Comic

知识漫画：教育、人物传记、教程。

Skill 元数据

参考：完整 SKILL.md

知识漫画创作助手

为适配 Hermes Agent 的工具生态，改编自 baoyu-comic。

用灵活的画风 × 调性组合创作原创知识漫画。

何时使用

当用户要求创作知识/教育漫画、人物传记漫画、教程漫画，或说出"知识漫画"、"教育漫画"、"Logicomix 风格"等说法时，触发本 skill。用户提供内容（文本、文件路径、URL 或主题），并可指定画风、调性、版式、宽高比或语言。

参考图

Hermes 的 image_generate 工具只接受提示词——它接受一个文本提示词和一个宽高比，返回一个图片 URL。它不接受参考图。当用户提供参考图时，用它以文字提取特征，再嵌入每一页的提示词：

接单：用户提供文件路径时就接受（或在对话里粘贴图片）。

• 文件路径 → 复制到漫画输出旁的 refs/NN-ref-{slug}.{ext}，留作出处
• 无路径的粘贴图 → 用 clarify 向用户要路径，或以文字口头提取风格特征作为回退
• 无参考图 → 跳过本节

用法模式（按每张参考图）：

存在参考图时，在每页提示词的 frontmatter 中记录：

references:
  - ref_id: 01
    filename: 01-ref-scene.png
    usage: style
    traits: "muted earth tones, soft-edged ink wash, low-contrast backgrounds"

角色一致性由 characters/characters.md（第 3 步写）里的文字描述驱动，这些描述在第 5 步内联嵌入每页提示词。第 7.1 步生成的可选 PNG 角色表是给人看的复核产物，不是 image_generate 的输入。

选项

视觉维度

部分工作流选项

细节：references/partial-workflows.md

画风、调性与预设目录

• 画风（6 种）：ligne-claire、manga、realistic、ink-brush、chalk、minimalist。完整定义见 references/art-styles/<style>.md。

• 调性（7 种）：neutral、warm、dramatic、romantic、energetic、vintage、action。完整定义见 references/tones/<tone>.md。

• 预设（5 个），在普通画风+调性之外有特殊规则：

  预设	等价于	钩子
  ohmsha	manga + neutral	视觉隐喻、不要说话头、道具揭示
  wuxia	ink-brush + action	气功效果、战斗画面、氛围感
  shoujo	manga + romantic	装饰元素、眼部细节、浪漫节拍
  concept-story	manga + warm	视觉符号系统、成长弧线、对话与动作平衡
  four-panel	minimalist + neutral + 四格版式	起承转合结构、黑白+一点缀色、火柴人角色

  完整规则见 references/presets/<preset>.md——选了预设就加载该文件。

• 兼容性矩阵和内容信号 → 预设表见 references/auto-selection.md。在第 2 步推荐组合前先读它。

文件结构

输出目录：comic/{topic-slug}/

• Slug：由主题取 2-4 个词的 kebab-case（例如 alan-turing-bio）
• 冲突：追加时间戳（例如 turing-story-20260118-143052）

内容： | 文件 | 说明 | |------|------| | source-{slug}.md | 保存的源内容（kebab-case slug 与输出目录一致） | | analysis.md | 内容分析 | | storyboard.md | 带分镜拆解的故事板 | | characters/characters.md | 角色定义 | | characters/characters.png | 角色参考表（从 image_generate 下载） | | prompts/NN-{cover\|page}-[slug].md | 生成提示词 | | NN-{cover\|page}-[slug].png | 生成的图片（从 image_generate 下载） | | refs/NN-ref-{slug}.{ext} | 用户提供的参考图（可选，留作出处） |

语言处理

检测优先级：

1. 用户指定的语言（显式选项）
2. 用户对话语言
3. 源内容语言

规则：所有交互都用用户的输入语言：

• 故事板大纲和场景描述
• 图片生成提示词
• 用户选择选项和确认
• 进度更新、提问、报错、总结

技术术语保留英文。

工作流

进度清单

Comic Progress:
- [ ] Step 1: Setup & Analyze
  - [ ] 1.1 Analyze content
  - [ ] 1.2 Check existing directory
- [ ] Step 2: Confirmation - Style & options ⚠️ REQUIRED
- [ ] Step 3: Generate storyboard + characters
- [ ] Step 4: Review outline (conditional)
- [ ] Step 5: Generate prompts
- [ ] Step 6: Review prompts (conditional)
- [ ] Step 7: Generate images
  - [ ] 7.1 Generate character sheet (if needed) → characters/characters.png
  - [ ] 7.2 Generate pages (with character descriptions embedded in prompt)
- [ ] Step 8: Completion report

流程

Input → Analyze → [Check Existing?] → [Confirm: Style + Reviews] → Storyboard → [Review?] → Prompts → [Review?] → Images → Complete

步骤摘要

用户提问

用 clarify 工具确认选项。把相互独立的问题放进一个 questions 数组（最多 5 个）；凡选项依赖前一个答案的问题，单独问。完整的第 2 步问题集见 references/workflow.md。

超时处理（关键）：clarify 可能返回 "outcome": "timed_out"，响应被标为 "status": "unanswered"——这不等于用户同意全部用默认值。

• 仅把它当作那些未回答问题的默认。每个问题都是一个独立的同意点。
• 在下一条消息里把默认值显式告诉用户，让他们有机会纠正：例如 "Style: defaulted to ohmsha preset (clarify timed out). Say the word to switch."——一个没报告的默认值，和从没问过无法区分。
• 不要在一次超时后就把第 2 步坍缩成一遍"全用默认"。若用户真的不在，他们对五个问题同样都不在场——但他们回来时能纠正看得见的默认，纠正不了看不见的。

第 7 步：图片生成

所有图片渲染都用 Hermes 内置的 image_generate 工具。它的 schema 只接受 prompt 和 aspect_ratio（landscape | portrait | square）；它返回一个 URL，不是本地文件。因此每一页或角色表生成后都必须下载到输出目录。

提示词文件要求（硬性）：在调用 image_generate 之前，把每张图完整、最终的提示词写到 prompts/ 下的独立文件（命名：NN-{type}-[slug].md）。提示词文件就是可复现记录。

宽高比映射——故事板的 aspect_ratio 字段按如下方式映射到 image_generate 的格式：

下载步骤——每次 image_generate 调用后：

1. 从工具结果读出 URL
2. 用绝对输出路径抓取图片字节，例如 curl -fsSL "<url>" -o /abs/path/to/comic/<slug>/NN-page-<slug>.png
3. 在进入下一页之前，确认该确切路径下文件存在且非空

绝不要让 -o 路径依赖 shell 当前工作目录。 终端工具的持久 shell CWD 在批次间可能变化（会话过期、TERMINAL_LIFETIME_SECONDS、一次失败的 cd 让你留在错误目录）。curl -o relative/path.png 是个静默坑：若 CWD 漂移，文件会落到别处，且不报错。始终给 -o 传全限定绝对路径，或给终端工具传 workdir=<绝对路径>。2026 年 4 月事故：一部 10 页漫画的第 06-09 页落到了仓库根目录而非 comic/<slug>/，因为第 3 批继承了第 2 批的过期 CWD，curl -o 06-page-skills.png 写到了错误目录。随后 agent 又花了好几轮声称文件在它不在的地方。

7.1 角色表——当漫画是多页且有反复出现的角色时，生成它（到 characters/characters.png，宽高比 landscape）。简单预设（例如四格极简）或单页漫画跳过。调用 image_generate 之前，characters/characters.md 处的提示词文件必须存在。渲染出的 PNG 是给人看的复核产物（让用户目视确认角色设计），也是日后重新生成或手工改提示词的参考——它不驱动第 7.2 步。页面提示词已在第 5 步根据 characters/characters.md 里的文字描述写好；image_generate 不能接受图片作为视觉输入。

7.2 页面——调用 image_generate 之前，每页提示词必须已在 prompts/NN-{cover|page}-[slug].md。因为 image_generate 只接受提示词，角色一致性是靠在第 5 步把角色描述（来自 characters/characters.md）内联嵌入每页提示词来保证的。无论 7.1 是否产出 PNG 表，嵌入都统一做；PNG 只是复核/重生成辅助。

备份规则：已存在的 prompts/…md 和 …png 文件 → 重新生成前重命名，加 -backup-YYYYMMDD-HHMMSS 后缀。

完整分步工作流（分析、分镜、复核门禁、重生成变体）：references/workflow.md。

参考

核心模板：

• analysis-framework.md - 深度内容分析
• character-template.md - 角色定义格式
• storyboard-template.md - 故事板结构
• ohmsha-guide.md - Ohmsha 漫画细节

风格定义：

• references/art-styles/ - 画风（ligne-claire, manga, realistic, ink-brush, chalk, minimalist）
• references/tones/ - 调性（neutral, warm, dramatic, romantic, energetic, vintage, action）
• references/presets/ - 带特殊规则的预设（ohmsha, wuxia, shoujo, concept-story, four-panel）
• references/layouts/ - 版式（standard, cinematic, dense, splash, mixed, webtoon, four-panel）

工作流：

• workflow.md - 完整工作流细节
• auto-selection.md - 内容信号分析
• partial-workflows.md - 部分工作流选项

页面修改

重要：更新页面时，始终在重新生成之前先更新提示词文件（prompts/NN-{cover|page}-[slug].md）。这保证改动有据可查、可复现。

常见坑

• 图片生成：每页 10-30 秒；失败自动重试一次
• 始终下载 image_generate 返回的 URL 到本地 PNG——下游工具（和用户复核）期待输出目录里有文件，而非临时 URL
• curl -o 用绝对路径——绝不要跨批次依赖持久 shell CWD。静默坑：文件落到错误目录，随后在目标路径 ls 什么都看不到。见第 7 步"下载步骤"。
• 敏感公众人物用风格化替代形象
• 第 2 步确认是必需的——不要跳过
• 第 4/6 步是条件的——仅当用户在第 2 步要求时
• 第 7.1 步角色表——多页漫画推荐，简单预设可选。PNG 只是复核/重生成辅助；页面提示词（第 5 步写）用 characters/characters.md 里的文字描述，不用 PNG。image_generate 不接受图片作为视觉输入
• 剥离机密 —— 写任何输出文件前，扫描源内容中的 API key、token 或凭据