baoyu-comic

知识漫画创作器

通过灵活组合画风与基调，创作原创知识漫画。

用法

/baoyu-comic posts/turing-story/source.md
/baoyu-comic article.md --art manga --tone warm
/baoyu-comic  # then paste content

选项

视觉维度

选项	值	说明
--art	ligne-claire（默认）、manga、realistic、ink-brush、chalk	画风／绘制技法
--tone	neutral（默认）、warm、dramatic、romantic、energetic、vintage、action	情绪／氛围
--layout	standard（默认）、cinematic、dense、splash、mixed、webtoon	分格布局
--aspect	3:4（默认，竖版）、4:3（横版）、16:9（宽屏）	页面宽高比
--lang	auto（默认）、zh、en、ja 等	输出语言

部分工作流选项

选项	说明
--storyboard-only	仅生成分镜，跳过提示词和图像
--prompts-only	生成分镜和提示词，跳过图像
--images-only	根据现有提示词目录生成图像
--regenerate N	仅重新生成指定页面（例如 3 或 2,5,8）

详情：references/partial-workflows.md

画风（画风）

画风	中文	说明
ligne-claire	清线	线条均匀、色彩平涂，欧洲漫画传统（Tintin、Logicomix）
manga	日漫	大眼睛、漫画表现手法、情绪表达丰富
realistic	写实	数字绘画、写实比例、精致细腻
ink-brush	水墨	中国笔触、水墨效果
chalk	粉笔	黑板美学，手绘质感温暖

基调（基调）

基调	中文	说明
neutral	中性	平衡、理性、具有教育性
warm	温馨	怀旧、个人化、令人安心
dramatic	戏剧	高对比度、强烈、有力量
romantic	浪漫	柔和、优美，带有装饰元素
energetic	活力	明亮、动感、令人振奋
vintage	复古	历史感、年代感、忠于时代特色
action	动作	速度线、冲击效果、格斗

预设快捷选项

除画风和基调外，还包含特殊规则的预设：

预设	等效选项	特殊规则
--style ohmsha	--art manga --tone neutral	使用视觉隐喻，不得出现对话头像，展示装置
--style wuxia	--art ink-brush --tone action	气的效果、格斗视觉效果、氛围元素
--style shoujo	--art manga --tone romantic	装饰元素、眼部细节、浪漫桥段

兼容性矩阵

画风	✓✓ 最佳	✓ 适用	✗ 避免
ligne-claire	neutral、warm	dramatic、vintage、energetic	romantic、action
manga	neutral、romantic、energetic、action	warm、dramatic	vintage
realistic	neutral、warm、dramatic、vintage	action	romantic、energetic
ink-brush	neutral、dramatic、action、vintage	warm	romantic、energetic
chalk	neutral、warm、energetic	vintage	dramatic、action、romantic

详情：references/auto-selection.md

自动选择

内容信号决定默认画风、基调和布局（或预设）：

内容信号	推荐选项
教程、操作指南、编程、教育内容	ohmsha 预设
1950 年以前、古典、古代	realistic + vintage
个人故事、导师	ligne-claire + warm
武术、武侠	wuxia 预设
浪漫、校园生活	shoujo 预设
传记、均衡	ligne-claire + neutral

推荐使用预设时：加载 references/presets/{preset}.md，并应用所有特殊规则。

详情：references/auto-selection.md

脚本目录

重要：所有脚本都位于此技能的 scripts/ 子目录中。

Agent 执行说明：

1. 将此 SKILL.md 文件所在目录路径确定为 {baseDir}
2. 脚本路径 = {baseDir}/scripts/<script-name>.ts
3. 将本文档中的所有 {baseDir} 替换为实际路径
4. 解析 ${BUN_X} 运行时：如果已安装 bun → bun；如果可用 npx → npx -y bun；否则建议安装 bun

脚本参考：

脚本	用途
scripts/merge-to-pdf.ts	将漫画页面合并为 PDF

文件结构

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

• Slug：根据主题使用 2-4 个单词组成 kebab-case（例如，alan-turing-bio）
• 冲突：追加时间戳（例如，turing-story-20260118-143052）

内容：

文件	描述
source-{slug}.{ext}	源文件
analysis.md	内容分析
storyboard.md	含分格拆解的分镜脚本
characters/characters.md	角色定义
characters/characters.png	角色参考表
prompts/NN-{cover|page}-[slug].md	生成提示词
NN-{cover|page}-[slug].png	生成的图像
{topic-slug}.pdf	最终合并的 PDF

语言处理

检测优先级：

1. --lang 标记（显式指定）
2. EXTEND.md language 设置
3. 用户的对话语言
4. 源内容语言

规则：所有交互均使用用户的输入语言或已保存的语言偏好：

• 分镜大纲和场景描述
• 图像生成提示词
• 用户选择选项和确认
• 进度更新、问题、错误和摘要

技术术语保留英文。

工作流

进度清单

Comic Progress:
- [ ] Step 1: Setup & Analyze
  - [ ] 1.1 Preferences (EXTEND.md) ⛔ BLOCKING
    - [ ] Found → load preferences → continue
    - [ ] Not found → run first-time setup → MUST complete before other steps
  - [ ] 1.2 Analyze, 1.3 Check existing
- [ ] 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 ⚠️ CHARACTER REF REQUIRED
  - [ ] 7.1 Generate character sheet FIRST → characters/characters.png
  - [ ] 7.2 Generate pages WITH --ref characters/characters.png
- [ ] Step 8: Merge to PDF
- [ ] Step 9: Completion report

流程

Input → [Preferences] ─┬─ Found → Continue
                       │
                       └─ Not found → First-Time Setup ⛔ BLOCKING
                                      │
                                      └─ Complete setup → Save EXTEND.md → Continue
                                                                              │
        ┌─────────────────────────────────────────────────────────────────────┘
        ↓
Analyze → [Check Existing?] → [Confirm: Style + Reviews] → Storyboard → [Review?] → Prompts → [Review?] → Images → PDF → Complete

步骤摘要

步骤	操作	关键输出
1.1	加载 EXTEND.md 偏好设置；如果未找到则 ⛔ 阻塞	已加载配置
1.2	分析内容	analysis.md
1.3	检查现有目录	处理冲突
2	确认风格、重点、受众和审核方式	用户偏好
3	生成分镜脚本 + 角色	storyboard.md、characters/
4	审核大纲（如有请求）	用户批准
5	生成提示词	prompts/*.md
6	审核提示词（如有请求）	用户批准
7.1	先生成角色参考表	characters/characters.png
7.2	使用角色参考图生成页面	*.png 文件
8	合并为 PDF	{slug}.pdf
9	完成报告	摘要

步骤 7：图像生成 ⚠️ 关键

角色参考是确保视觉一致性的必要条件。

7.1 先生成角色设定图：

• 备份规则：如果 characters/characters.png 已存在，将其重命名为 characters/characters-backup-YYYYMMDD-HHMMSS.png
• 调用已安装的图像生成技能，例如 baoyu-imagine
• 阅读该技能的 SKILL.md，并遵循其中记录的接口，而不是直接调用其脚本
• 使用 characters/characters.md 作为提示词文件输入
• 将输出保存到 characters/characters.png
• 使用宽高比 4:3

压缩角色设定图（推荐）： 压缩图像，以减少将其用作参考图像时的 token 用量：

• 使用可用的图像压缩技能（如果有）
• 或使用系统工具：pngquant、optipng、sips（macOS）
• 保留 PNG 格式，优先使用无损压缩

7.2 生成每一页时都要使用角色参考图：

技能能力	策略
支持 --ref	每一页都传入 characters/characters.png
不支持 --ref	将角色描述添加到每个提示词文件的开头

页面生成的备份规则：

• 如果提示词文件已存在：将其重命名为 prompts/NN-{cover|page}-[slug]-backup-YYYYMMDD-HHMMSS.md
• 如果图像文件已存在：将其重命名为 NN-{cover|page}-[slug]-backup-YYYYMMDD-HHMMSS.png
• 为每一页调用已安装的图像生成技能
• 使用 prompts/01-page-xxx.md 作为提示词文件输入
• 将输出保存到 01-page-xxx.png
• 使用宽高比 3:4
• 如果所选技能支持参考图像，将 characters/characters.png 作为 --ref 传入

完整工作流详情：references/workflow.md

EXTEND.md 路径 ⛔ 阻塞

关键：如果未找到 EXTEND.md，必须先完成首次设置，然后才能进行任何其他提问或步骤。不要继续进行内容分析，不要询问艺术风格，也不要询问语气——只能先完成偏好设置。

路径	位置
.baoyu-skills/baoyu-comic/EXTEND.md	项目目录
$HOME/.baoyu-skills/baoyu-comic/EXTEND.md	用户主目录

结果	操作
已找到	阅读、解析并显示摘要 → 继续
未找到	⛔ 阻塞：仅运行首次设置（references/config/first-time-setup.md）→ 完成并保存 EXTEND.md → 然后继续

EXTEND.md 支持：水印 | 首选艺术风格/语气/布局 | 自定义风格定义 | 角色预设 | 语言偏好

架构：references/config/preferences-schema.md

参考资料

核心模板：

• analysis-framework.md - 深度内容分析
• character-template.md - 角色定义格式
• storyboard-template.md - 分镜结构
• ohmsha-guide.md - Ohmsha 漫画规范

风格定义：

• references/art-styles/ - 艺术风格（ligne-claire、manga、realistic、ink-brush、chalk）
• references/tones/ - 语气（neutral、warm、dramatic、romantic、energetic、vintage、action）
• references/presets/ - 带有特殊规则的预设（ohmsha、wuxia、shoujo）
• references/layouts/ - 布局（standard、cinematic、dense、splash、mixed、webtoon）

工作流：

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

配置：

• config/preferences-schema.md - EXTEND.md 架构
• config/first-time-setup.md - 首次设置
• config/watermark-guide.md - 水印配置

页面修改

操作	步骤
编辑	先更新提示词文件 → --regenerate N → 重新生成 PDF
添加	在指定位置创建提示词 → 使用角色参考生成 → 重新编号后续页面 → 更新分镜脚本 → 重新生成 PDF
删除	删除文件 → 重新编号后续页面 → 更新分镜脚本 → 重新生成 PDF

重要提示：更新页面时，务必先更新提示词文件（prompts/NN-{cover|page}-[slug].md），再重新生成。这样可以确保更改有据可查且可复现。

注意事项

• 图像生成：每页需 10-30 秒
• 生成失败时自动重试一次
• 对敏感公众人物使用风格化替代形象
• 通过会话 ID 保持风格一致
• 必须确认步骤 2——不可跳过
• 步骤 4/6 为条件步骤——仅在用户于步骤 2 中提出要求时执行
• 必须在生成页面前生成步骤 7.1 的角色设定表——确保一致性
• 每个页面都必须在步骤 7.2 中引用角色——使用 --ref 或嵌入描述
• 在 EXTEND.md 中一次性配置水印/语言