关于 baoyu-comic
baoyu-comic 是将源材料转为知识漫画的 Agent 技能，可配置画风、基调、布局和语言，并分阶段生成分镜、提示词、角色参考图、页面和 PDF。
主要功能
- 01选择画风、基调、布局和宽高比
- 02根据内容自动选择风格
- 03生成分镜和图像提示词
- 04制作角色参考图和漫画页面
- 05重新生成指定页面并合并为 PDF
适用场景
- 01将教育文章改编成漫画
- 02按指定画风创作人物传记漫画
- 03只修改选定页面，无需重做整部漫画
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/baoyu-comic确认已加载。
包含的文件
除 SKILL.md 外，安装时一起下载的参考资料和脚本。
references/analysis-framework.mdauto-selection.mdbase-prompt.mdcharacter-template.mdohmsha-guide.mdpartial-workflows.mdstoryboard-template.mdreferences/art-styles/chalk.mdink-brush.mdligne-claire.mdmanga.mdrealistic.mdreferences/config/first-time-setup.mdpreferences-schema.mdwatermark-guide.mdreferences/layouts/cinematic.mddense.mdmixed.mdsplash.mdstandard.mdwebtoon.mdreferences/presets/ohmsha.mdshoujo.mdwuxia.mdreferences/tones/action.mddramatic.mdenergetic.mdneutral.mdromantic.mdvintage.md详细介绍
知识漫画创作器
通过灵活组合画风与基调，创作原创知识漫画。
用法
/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 执行说明：
- 将此 SKILL.md 文件所在目录的路径确定为
SKILL_DIR - 脚本路径 =
${SKILL_DIR}/scripts/<script-name>.ts - 将本文档中的所有
${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 |
语言处理
检测优先级：
--lang标志（显式指定）- EXTEND.md 中的
language设置 - 用户的对话语言
- 源内容语言
规则：所有交互都使用用户输入的语言或已保存的语言偏好：
- 故事板大纲和场景描述
- 图像生成提示词
- 用户选择选项和确认
- 进度更新、问题、错误、摘要
技术术语保留英文。
工作流
进度清单
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
# 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
压缩角色参考图（推荐）： 压缩以减少将其用作参考图时的 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
# 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 路径 ⛔ 阻塞
重要：如果找不到 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 中配置一次
评论
支持 Markdown