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 文件所在目录路径设为 SKILL_DIR
2. 脚本路径 = ${SKILL_DIR}/scripts/<script-name>.ts
3. 将本文档中的所有 ${SKILL_DIR} 替换为实际路径

脚本参考：

脚本	用途
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, 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 → 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 首先生成角色参考表：

# Use Reference Sheet Prompt from characters/characters.md
npx -y bun ${SKILL_DIR}/../baoyu-image-gen/scripts/main.ts \
  --promptfiles characters/characters.md \
  --image characters/characters.png --ar 4:3

7.2 使用角色参考图生成每个页面：

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

# Example: ALWAYS include --ref for consistency
npx -y bun ${SKILL_DIR}/../baoyu-image-gen/scripts/main.ts \
  --promptfiles prompts/01-page-xxx.md \
  --image 01-page-xxx.png --ar 3:4 \
  --ref characters/characters.png

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

EXTEND.md 路径

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

EXTEND.md 支持：水印 | 首选画风／基调／布局 | 自定义风格定义 | 角色预设 | 语言偏好

Schema：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 - 水印配置

注意事项

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