Baoyu Comic
知识漫画(Knowledge comic):教育类、传记类、教程类。
Skill 元数据
| Source | Optional — 使用 kopi skills install official/creative/baoyu-comic 安装 |
| Path | optional-skills/creative/baoyu-comic |
| Version | 1.56.1 |
| Author | 宝玉 (JimLiu) |
| License | MIT |
| Platforms | linux, macos, windows |
| Tags | comic, knowledge-comic, creative, image-generation |
参考:完整的 SKILL.md
以下是触发该 skill 时 Kopi Agent 加载的完整 skill 定义。当 skill 处于激活状态时,agent 会将这些内容视为指令。
知识漫画创作器
改编自 baoyu-comic,以适配 KOPI AI AGENT 的工具生态。
创作原创知识漫画,支持灵活的艺术风格 × 基调组合。
何时使用
当用户要求创作知识/教育类漫画、传记类漫画、教程类漫画,或使用"知识漫画"、"教育漫画"、"Logicomix 风格"等术语时,触发此 skill。用户提供内容(文本、文件路径、URL 或主题),并可选择指定艺术风格、基调、布局、宽高比或语言。
参考图片
Kopi Agent 的 image_generate 工具是纯提示词的——它接受一段文本提示和一个宽高比,然后返回一个图片 URL。它不接受参考图片。当用户提供参考图片时,将其用于以文本形式提取特征,并嵌入到每个页面的提示中:
接收:用户提供文件路径时接受文件路径(或在对话中粘贴图片)。
- 文件路径 → 复制到
refs/NN-ref-{slug}.{ext}(与漫画输出同目录),以供溯源 - 粘贴图片但无路径 → 通过
clarify向用户询问路径,或以文本回退方式口头提取风格特征 - 无参考 → 跳过本节
使用模式(每个参考):
| 用法 | 效果 |
|---|---|
style | 提取风格特征(线条处理、质感、氛围),并附加到每个页面的提示正文末尾 |
palette | 提取十六进制颜色,并附加到每个页面的提示正文末尾 |
scene | 提取场景构图或主体说明,并附加到相关页面的提示中 |
当存在参考时,在每个页面的提示 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 的输入。
选项
视觉维度
| 选项 | 取值 | 描述 |
|---|---|---|
| Art | ligne-claire(默认)、manga、realistic、ink-brush、chalk、minimalist | 艺术风格 / 渲染技法 |
| Tone | neutral(默认)、warm、dramatic、romantic、energetic、vintage、action | 情绪 / 氛围 |
| Layout | standard(默认)、cinematic、dense、splash、mixed、webtoon、four-panel | 分镜布局 |
| Aspect | 3:4(默认,竖版)、4:3(横版)、16:9(宽屏) | 页面宽高比 |
| Language | auto(默认)、zh、en、ja 等 | 输出语言 |
| Refs | 文件路径 | 用于风格 / 配色特征提取的参考图片(不会传递给图像模型)。参见上文参考图片。 |
部分工作流选项
| 选项 | 描述 |
|---|---|
| Storyboard only | 仅生成分镜脚本,跳过提示词和图片 |
| Prompts only | 生成分镜脚本 + 提示词,跳过图片 |
| Images only | 从现有的 prompts 目录生成图片 |
| Regenerate N | 仅重新生成指定页面(例如 3 或 2,5,8) |
详情请参见 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 种),除普通艺术风格 + 基调组合外还带有特殊规则:
预设 等价组合 亮点 ohmshamanga + neutral 视觉隐喻、避免"谈话头"、道具揭示 wuxiaink-brush + action 气劲特效、战斗视觉、氛围渲染 shoujomanga + romantic 装饰元素、眼部细节、浪漫情节 concept-storymanga + warm 视觉符号体系、成长弧线、对话与动作的平衡 four-panelminimalist + neutral + four-panel 布局 起承转合结构、黑白 + 点缀色、简笔画角色 完整规则见
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} | 用户提供的参考图片(可选,用于溯源) |
语言处理
检测优先级:
- 用户指定的语言(显式选项)
- 用户对话使用的语言
- 源内容的语言
规则:所有交互均使用用户的输入语言:
- 分镜大纲和场景描述
- 图像生成 prompt
- 用户选择选项和确认
- 进度更新、问题、错误、总结
技术术语保留英文。
工作流程
进度清单
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
步骤摘要
| 步骤 | 操作 | 关键输出 |
|---|---|---|
| 1.1 | 分析内容 | analysis.md, source-{slug}.md |
| 1.2 | 检查现有目录 | 处理冲突 |
| 2 | 确认风格、重点、受众、评审需求 | 用户偏好 |
| 3 | 生成分镜 + 角色 | storyboard.md, characters/ |
| 4 | 评审大纲(如需要) | 用户批准 |
| 5 | 生成 prompt | prompts/*.md |
| 6 | 评审 prompt(如需要) | 用户批准 |
| 7.1 | 生成角色设定图(如需要) | characters/characters.png |
| 7.2 | 生成页面 | *.png 文件 |
| 8 | 完成报告 | 总结 |
用户提问
使用 clarify 工具确认选项。由于 clarify 一次只能处理一个问题,请先询问最重要的问题,然后按顺序依次进行。完整的 Step 2 问题集请参阅 references/workflow.md。
超时处理(关键):clarify 可能返回 "The user did not provide a response within the time limit. Use your best judgement to make the choice and proceed." —— 这不代表用户同意将所有选项都设为默认值。
- 应将其视为仅针对该问题的默认值。继续按顺序询问剩余的 Step 2 问题;每个问题都是独立的同意点。
- 在你的下一条消息中向用户显著展示该默认值,以便他们有机会更正:例如
"Style: defaulted to ohmsha preset (clarify timed out). Say the word to switch."—— 未展示的默认值与从未询问过毫无区别。 - 不要在一次超时后将 Step 2 压缩为一次"全部使用默认值"的处理。如果用户确实不在,那么他们对所有五个问题都同样不在 —— 但当他们回来时可以更正可见的默认值,却无法更正不可见的默认值。
Step 7:图像生成
所有图像渲染均使用 Kopi Agent 内置的 image_generate 工具。其 schema 仅接受 prompt 和 aspect_ratio(landscape | portrait | square);它返回一个 URL,而不是本地文件。因此,每个生成的页面或角色设定图都必须下载到输出目录。
Prompt 文件要求(强制):在调用 image_generate 之前,必须将每张图像完整、最终的 prompt 写入 prompts/ 下的独立文件(命名:NN-{type}-[slug].md)。该 prompt 文件是可复现性记录。
宽高比映射 —— 分镜中的 aspect_ratio 字段与 image_generate 的格式对应如下:
| 分镜宽高比 | image_generate 格式 |
|---|---|
3:4, 9:16, 2:3 | portrait |
4:3, 16:9, 3:2 | landscape |
1:1 | square |
下载步骤 —— 每次 image_generate 调用之后:
- 从工具结果中读取 URL
- 使用绝对输出路径获取图像字节数据,例如
curl -fsSL "<url>" -o /abs/path/to/comic/<slug>/NN-page-<slug>.png - 在继续下一页之前,验证该确切路径上文件存在且非空
切勿依赖 shell CWD 持久化来处理 -o 路径。 终端工具持久化 shell 的 CWD 可能在批次之间发生变化(会话过期、TERMINAL_LIFETIME_SECONDS、失败的 cd 导致你停留在错误的目录)。curl -o relative/path.png 是一个隐蔽的陷阱:如果 CWD 已漂移,文件会落到其他地方且不会报错。务必向 -o 传递完整限定的绝对路径,或向终端工具传递 workdir=<abs path>。2026 年 4 月事故:一部 10 页漫画的第 06-09 页落到了仓库根目录而不是 comic/<slug>/,因为第 3 批次从第 2 批次继承了过期的 CWD,curl -o 06-page-skills.png 写入了错误的目录。随后 agent 花了数个回合声称文件存在于它们并不在的位置。
7.1 角色设定图 —— 当漫画为多页且有反复出现的角色时,生成它(输出至 characters/characters.png,宽高比 landscape)。对于简单的预设(例如四格极简风)或单页漫画可跳过。characters/characters.md 处的 prompt 文件必须在调用 image_generate 之前存在。渲染出的 PNG 是面向人类的评审产物(以便用户能直观验证角色设计),也是后续重新生成或手动编辑 prompt 时的参考 —— 它不驱动 Step 7.2。页面 prompt 已在 Step 5 中根据 characters/characters.md 中的文本描述写好;image_generate 无法接受图像作为视觉输入。
7.2 页面 —— 在调用 image_generate 之前,每一页的 prompt 必须已经位于 prompts/NN-{cover|page}-[slug].md。由于 image_generate 仅接受 prompt,角色一致性是通过在 Step 5 中将角色描述(来源于 characters/characters.md)内嵌到每个页面 prompt 中来保证的。无论 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/- 画风(清晰线条、漫画、写实、水墨、粉笔、极简)references/tones/- 基调(中性、温暖、戏剧性、浪漫、活力、复古、动作)references/presets/- 含特殊规则的预设(ohmsha、武侠、少女、概念故事、四格)references/layouts/- 版式(标准、电影感、密集、跨页大图、混合、条漫、四格)
工作流程:
- workflow.md - 完整工作流详情
- auto-selection.md - 内容信号分析
- partial-workflows.md - 部分工作流选项
页面修改
| 操作 | 步骤 |
|---|---|
| 编辑 | 先更新 prompt 文件 → 重新生成图像 → 下载新的 PNG |
| 添加 | 在指定位置创建 prompt → 生成时内嵌角色描述 → 后续页面重新编号 → 更新分镜 |
| 删除 | 删除文件 → 后续页面重新编号 → 更新分镜 |
重要:更新页面时,务必在重新生成之前先更新 prompt 文件(prompts/NN-{cover|page}-[slug].md)。这可确保变更被记录且可复现。
常见陷阱
- 图像生成:每页 10-30 秒;失败时自动重试一次
- 务必下载
image_generate返回的 URL 并保存为本地 PNG —— 下游工具(以及用户审阅)期望文件位于输出目录中,而不是临时 URL - 对
curl -o使用绝对路径 —— 跨批次时不要依赖持久化 shell 的当前工作目录。这是一个隐蔽的坑:文件会落到错误的目录,之后在预期路径上执行ls会显示为空。参见步骤 7“下载步骤” - 对敏感公众人物使用风格化的替代形象
- 步骤 2 必须确认 —— 不可跳过
- 步骤 4/6 为条件执行 —— 仅当用户在步骤 2 中提出需求时才执行
- 步骤 7.1 角色设定图 —— 对多页漫画推荐使用,简单预设可选。该 PNG 仅用于审阅/重新生成的辅助参考;页面 prompt(在步骤 5 中编写)使用的是
characters/characters.md中的文本描述,而非 PNG。image_generate不接受图像作为视觉输入 - 清除敏感信息 —— 在写入任何输出文件之前,扫描源内容中的 API 密钥、token 或凭据