跳到主要内容

Baoyu Comic

知识漫画(Knowledge comic):教育类、传记类、教程类。

Skill 元数据​

SourceOptional — 使用 kopi skills install official/creative/baoyu-comic 安装
Pathoptional-skills/creative/baoyu-comic
Version1.56.1
Author宝玉 (JimLiu)
LicenseMIT
Platformslinux, macos, windows
Tagscomic, 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 的输入。

选项​

视觉维度​

选项取值描述
Artligne-claire(默认)、manga、realistic、ink-brush、chalk、minimalist艺术风格 / 渲染技法
Toneneutral(默认)、warm、dramatic、romantic、energetic、vintage、action情绪 / 氛围
Layoutstandard(默认)、cinematic、dense、splash、mixed、webtoon、four-panel分镜布局
Aspect3:4(默认,竖版)、4:3(横版)、16:9(宽屏)页面宽高比
Languageauto(默认)、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}用户提供的参考图片(可选,用于溯源)

语言处理​

检测优先级:

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

规则:所有交互均使用用户的输入语言:

  • 分镜大纲和场景描述
  • 图像生成 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生成 promptprompts/*.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:3portrait
4:3, 16:9, 3:2landscape
1:1square

下载步骤 —— 每次 image_generate 调用之后:

  1. 从工具结果中读取 URL
  2. 使用绝对输出路径获取图像字节数据,例如 curl -fsSL "<url>" -o /abs/path/to/comic/<slug>/NN-page-<slug>.png
  3. 在继续下一页之前,验证该确切路径上文件存在且非空

切勿依赖 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。

参考资料​

核心模板:

风格定义:

  • references/art-styles/ - 画风(清晰线条、漫画、写实、水墨、粉笔、极简)
  • references/tones/ - 基调(中性、温暖、戏剧性、浪漫、活力、复古、动作)
  • references/presets/ - 含特殊规则的预设(ohmsha、武侠、少女、概念故事、四格)
  • references/layouts/ - 版式(标准、电影感、密集、跨页大图、混合、条漫、四格)

工作流程:

页面修改​

操作步骤
编辑先更新 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 或凭据