| name | comic-guide |
| description | Generate AI-illustrated comic-style educational guides from documentation, source code, or any technical content. Produces actual comic PNG images using AI image generation (not HTML). Supports 10+ anime styles: Doraemon, Naruto, One Piece, Dragon Ball, Spy x Family, Chibi, Chinese ink, Ghibli, Crayon Shin-chan, Detective Conan, and custom. Each chapter outputs a multi-panel comic image with drawn characters, speech bubbles, and technical diagrams in cartoon style. Use when user asks to create comics, manga, illustrated guides, visual explainers, or cartoon-style tutorials. |
Comic Guide - 漫画风格图解生成器
将任何文档、源码或技术知识转化为 AI 绘制的漫画图片（PNG）。
命令格式
/comic-guide <source> [options]
| 参数 | 说明 | 示例 |
|---|
<source> | 文档路径、URL 或主题描述 | docs/api.md, "React Hooks 入门" |
--style | 漫画风格（默认 doraemon） | --style naruto |
--lang | 输出语言（默认 zh） | --lang en |
--chapters | 章节数（默认自动 3-8） | --chapters 5 |
--aspect | 图片比例（默认 16:9） | --aspect 3:4 |
--output | 输出目录 | --output ./my-comic/ |
--storyboard-only | 只生成分镜脚本，不生成图片 | |
--prompts-only | 只生成分镜+提示词，不生成图片 | |
风格选项
| ID | 名称 | 画风关键词 | 角色设定 | 适用场景 |
|---|
doraemon | 哆啦A梦 | 蓝白配色、圆润线条、可爱卡通、柔和色彩 | 哆啦A梦=导师，大雄=学习者，道具=技术概念 | 技术教程、架构解析 |
naruto | 火影忍者 | 热血动感、速度线、橙黑配色、动作感 | 鸣人=实践者，卡卡西=导师，忍术卷轴=文档 | 流程解析、实战教程 |
onepiece | 海贼王 | 航海图风格、冒险感、红蓝金配色 | 路飞=探索者，罗宾=知识者，船=系统 | 团队协作、系统组件 |
dragonball | 龙珠 | 战斗力数值、能量波、橙蓝配色 | 悟空=挑战者，界王=导师，战斗力探测器=性能 | 性能对比、基准测试 |
spyfamily | 间谍过家家 | 优雅档案风格、绿粉黑配色 | 黄昏=分析者，阿尼亚=好奇宝宝 | 安全系统、权限解析 |
chibi | Q版萌系 | 大头小身、粉彩、星星装饰 | 通用可爱角色 | 入门教程、快速上手 |
guofeng | 国风水墨 | 水墨晕染、宣纸纹理、朱红印章 | 仙人=导师，少侠=学习者 | 设计模式、哲学概念 |
ghibli | 吉卜力 | 水彩风、温暖自然、绿蓝棕配色 | 少年少女=探索者，精灵=辅助 | 生态系统、工作流 |
shinchan | 蜡笔小新 | 蜡笔画风、搞笑幽默、黄红蓝配色 | 小新=犯错者，风间=纠正者 | 避坑指南、常见错误 |
conan | 名侦探柯南 | 推理风格、暗色调、蓝红灰配色 | 柯南=分析者，博士=技术支持 | Debug 教程、问题排查 |
custom | 自定义 | 用户自然语言描述 | 用户自定义 | 任意场景 |
核心工作流
输入 → 内容分析 → 分镜脚本 → 角色定义 → 图像提示词 → AI 图像生成 → PNG 输出
Phase 1: 内容分析
- 读取
<source> 内容（文件/URL/文本描述）
- 提取核心知识点，按逻辑拆分为 3-8 个章节
- 为每章确定：标题、核心概念（2-4 个）、难度级别
- 输出
analysis.md
Phase 2: 分镜脚本
为每章设计 4-6 个面板的分镜脚本，输出 storyboard.md。
面板类型与节奏：
| 类型 | 用途 | 占比 |
|---|
title | 章节标题面板，大字+角色 | 每话 1 个 |
dialogue | 角色对话讲解概念，对话气泡 | 30-40% |
diagram | 架构图/流程图，以漫画风格绘制 | 20-30% |
info | 知识要点面板，图标+列表 | 10-20% |
reaction | 角色表情反应，增加趣味 | 10% |
summary | 本话总结，木牌/卷轴/公告板形式 | 每话 1 个 |
分镜规则：
- 每话 4-6 个面板，横版 2x2 或 2x3 布局
- 开头必有
title 面板
diagram 前必有 dialogue 铺垫- 结尾必有
summary 面板
Phase 3: 角色定义
输出 characters.md，描述每个角色的视觉特征：
## 角色表
### 导师角色
- 名称：哆啦A梦
- 外观：蓝色圆滚滚的机器猫，白色肚皮，红鼻子，黄色铃铛项圈
- 表情变化：讲解时自信微笑，强调时举起手指，展示道具时从口袋掏出
- 对话气泡颜色：浅蓝色
### 学习者角色
- 名称：大雄
- 外观：黑发男孩，戴大圆框眼镜，黄色上衣
- 表情变化：困惑时挠头，惊讶时张大嘴巴，领悟时竖起大拇指
- 对话气泡颜色：浅黄色
Phase 4: 图像提示词生成
为每话生成一份详细的图像生成提示词，保存为 prompts/NN-chapter-slug.md。
提示词结构（以哆啦A梦风格为例）：
A educational comic page in Doraemon anime art style, cute round character
designs, soft blue and white color scheme, clean lines.
Layout: landscape 16:9 ratio, [N] panels arranged in a [2x2 / 2x3] grid
with thin black panel borders and white gutters between panels.
Panel 1 (top-left, title panel):
[章节标题大字]，哆啦A梦站在左侧，举起右手，背景是[场景描述]。
对话气泡："[对话内容]"
Panel 2 (top-right):
[面板内容描述，角色位置、表情、动作]
对话气泡："[对话内容]"
Panel 3 (bottom-left, diagram):
[技术图解描述：用可爱卡通风格绘制的架构图/流程图，标注中文文字]
Panel 4 (bottom-right, summary):
[总结面板描述]
All text in Chinese. Speech bubbles with tails pointing to speakers.
Consistent character appearance across all panels.
详细的风格提示词模板见 styles.md。
提示词编写规范见 prompt-template.md。
Phase 5: AI 图像生成
根据运行平台选择图像生成方式：
| 平台 | 生成方式 | 操作 |
|---|
| Cursor | 内置 GenerateImage 工具 | 直接调用，传入提示词描述 |
| Claude Code | baoyu-imagine 技能 | /baoyu-imagine --prompt ... --image output.png |
| OpenClaw | image-gen 技能 | /image-gen --prompt ... --image output.png |
| 通用 | 将提示词保存为文件 | 用户自行调用任意图像生成工具 |
生成规则：
- 每话一张 PNG 图片
- 默认 16:9 横版（适合桌面/分享）；可选 3:4 竖版（适合手机/小红书）
- 文件命名：
NN-chapter-slug.png（如 01-overall-architecture.png）
Phase 6: 输出汇总
最终输出目录结构：
{topic}-guide/
├── analysis.md # 内容分析
├── storyboard.md # 分镜脚本
├── characters.md # 角色定义
├── prompts/ # 图像提示词
│ ├── 01-chapter-slug.md
│ ├── 02-chapter-slug.md
│ └── ...
├── 01-chapter-slug.png # 生成的漫画图片
├── 02-chapter-slug.png
└── ...
汇报：文件列表、章节数、风格、图片数量。
角色对话设计原则
- 导师角色发起话题，用简单比喻引入复杂概念
- 学习者角色提出困惑，代表读者的疑问
- 每轮对话不超过 2 句，保持紧凑（图片中文字不宜太多）
- 技术术语首次出现时用通俗比喻解释
- 每话结尾用学习者的"恍然大悟"表情收束
比喻映射规则
| 技术概念 | 哆啦A梦 | 火影忍者 | 海贼王 |
|---|
| API | 任意门 | 通灵术 | 电话虫 |
| 数据库 | 四次元口袋 | 封印卷轴 | 历史正文 |
| 缓存 | 记忆面包 | 影分身 | 镜之船 |
| 多线程 | 缩小灯分身 | 多重影分身 | 路飞的档 |
| 安全机制 | 独裁者按钮 | 结界术 | 霸气 |
| 框架 | 百宝袋 | 忍具包 | 海贼船 |
| 插件/模块 | 道具 | 忍术 | 恶魔果实 |
| 部署 | 时光机出发 | 出任务 | 出航 |
输出示例
对于 /comic-guide "OpenClaw 架构" --style doraemon --chapters 5：
openclaw-guide/
├── analysis.md
├── storyboard.md
├── characters.md
├── prompts/
│ ├── 01-what-is-openclaw.md
│ ├── 02-four-layer-architecture.md
│ ├── 03-skills-system.md
│ ├── 04-memory-and-security.md
│ └── 05-deployment.md
├── 01-what-is-openclaw.png # 第1话：四次元口袋里的小龙虾
├── 02-four-layer-architecture.png # 第2话：小龙虾的四层铠甲
├── 03-skills-system.png # 第3话：百宝袋就是 Skills
├── 04-memory-and-security.png # 第4话：记忆面包与安全头盔
└── 05-deployment.png # 第5话：一起养虾吧！
补充资源
