tuzi-comic

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Knowledge Comic Creator

知识漫画生成器

Create original knowledge comics with flexible art style × tone combinations.

支持灵活搭配画风与基调组合，创作原创知识漫画。

Usage

使用方法

bash

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

bash

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

Options

选项

Visual Dimensions

视觉维度

Option	Values	Description
`--art`	ligne-claire (default), manga, realistic, ink-brush, chalk	Art style / rendering technique
`--tone`	neutral (default), warm, dramatic, romantic, energetic, vintage, action	Mood / atmosphere
`--layout`	standard (default), cinematic, dense, splash, mixed, webtoon	Panel arrangement
`--aspect`	3:4 (default, portrait), 4:3 (landscape), 16:9 (widescreen)	Page aspect ratio
`--lang`	auto (default), zh, en, ja, etc.	Output language

选项	可选值	说明
`--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 等	输出语言

Partial Workflow Options

部分工作流选项

Option	Description
`--storyboard-only`	Generate storyboard only, skip prompts and images
`--prompts-only`	Generate storyboard + prompts, skip images
`--images-only`	Generate images from existing prompts directory
`--regenerate N`	Regenerate specific page(s) only (e.g., `3` or `2,5,8` )

Details: references/partial-workflows.md

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

详情: references/partial-workflows.md

Art Styles (画风)

画风

Style	中文	Description
`ligne-claire`	清线	Uniform lines, flat colors, European comic tradition (Tintin, Logicomix)
`manga`	日漫	Large eyes, manga conventions, expressive emotions
`realistic`	写实	Digital painting, realistic proportions, sophisticated
`ink-brush`	水墨	Chinese brush strokes, ink wash effects
`chalk`	粉笔	Chalkboard aesthetic, hand-drawn warmth

风格	中文	说明
`ligne-claire`	清线	线条统一、平涂色彩，欧洲漫画传统风格（《丁丁历险记》、《逻辑的引擎》）
`manga`	日漫	大眼睛、符合日漫创作惯例，情绪表达丰富
`realistic`	写实	数字绘画风格，比例写实，质感精致
`ink-brush`	水墨	中国毛笔笔触，水墨晕染效果
`chalk`	粉笔	黑板美学风格，手绘质感温暖

Tones (基调)

基调

Tone	中文	Description
`neutral`	中性	Balanced, rational, educational
`warm`	温馨	Nostalgic, personal, comforting
`dramatic`	戏剧	High contrast, intense, powerful
`romantic`	浪漫	Soft, beautiful, decorative elements
`energetic`	活力	Bright, dynamic, exciting
`vintage`	复古	Historical, aged, period authenticity
`action`	动作	Speed lines, impact effects, combat

基调	中文	说明
`neutral`	中性	平衡、理性、适合教育内容
`warm`	温馨	怀旧、个人向、有抚慰感
`dramatic`	戏剧	高对比、张力强、有冲击力
`romantic`	浪漫	柔和、美观、带有装饰元素
`energetic`	活力	明亮、动感、充满活力
`vintage`	复古	有历史感、年代质感、符合时代特征
`action`	动作	速度线、冲击效果、战斗场景

Preset Shortcuts

预设快捷方式

Presets with special rules beyond art+tone:

Preset	Equivalent	Special Rules
`--style ohmsha`	`--art manga --tone neutral`	Visual metaphors, NO talking heads, gadget reveals
`--style wuxia`	`--art ink-brush --tone action`	Qi effects, combat visuals, atmospheric elements
`--style shoujo`	`--art manga --tone romantic`	Decorative elements, eye details, romantic beats

预设包含超出画风+基调组合的特殊规则：

预设	等效配置	特殊规则
`--style ohmsha`	`--art manga --tone neutral`	视觉隐喻、无对话头像、创意装置展示
`--style wuxia`	`--art ink-brush --tone action`	气效、战斗视觉效果、氛围感元素
`--style shoujo`	`--art manga --tone romantic`	装饰元素、眼部细节、浪漫情节

Compatibility Matrix

兼容性矩阵

Art Style	✓✓ Best	✓ Works	✗ Avoid
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

Details: references/auto-selection.md

画风	✓✓ 最佳适配	✓ 兼容可用	✗ 不推荐
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

Auto Selection

自动选择

Content signals determine default art + tone + layout (or preset):

Content Signals	Recommended
Tutorial, how-to, programming, educational	ohmsha preset
Pre-1950, classical, ancient	realistic + vintage
Personal story, mentor	ligne-claire + warm
Martial arts, wuxia	wuxia preset
Romance, school life	shoujo preset
Biography, balanced	ligne-claire + neutral

When preset is recommended: Load

references/presets/{preset}.md

and apply all special rules.

Details: references/auto-selection.md

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

内容信号	推荐配置
教程、操作指南、编程、教育内容	ohmsha 预设
1950年前内容、古典、古代内容	realistic + vintage
个人故事、导师相关内容	ligne-claire + warm
武术、武侠内容	wuxia 预设
爱情、校园生活内容	shoujo 预设
传记、平衡向内容	ligne-claire + neutral

推荐使用预设时：加载

references/presets/{preset}.md

并应用所有特殊规则。

详情: references/auto-selection.md

Script Directory

脚本目录

Important: All scripts are located in the

scripts/

subdirectory of this skill.

Agent Execution Instructions:

Determine this SKILL.md file's directory path as
```
SKILL_DIR
```
Script path =
```
${SKILL_DIR}/scripts/<script-name>.ts
```
Replace all
```
${SKILL_DIR}
```
in this document with the actual path

Script Reference:

Script	Purpose
`scripts/merge-to-pdf.ts`	Merge comic pages into PDF

重要提示：所有脚本都存放在本skill的

scripts/

子目录下。

Agent执行说明:

将本SKILL.md文件所在目录路径设为
```
SKILL_DIR
```
脚本路径 =
```
${SKILL_DIR}/scripts/<script-name>.ts
```
将本文档中所有
```
${SKILL_DIR}
```
替换为实际路径

脚本参考:

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

File Structure

文件结构

Output directory:

comic/{topic-slug}/

Slug: 2-4 words kebab-case from topic (e.g.,
```
alan-turing-bio
```
)
Conflict: append timestamp (e.g.,
```
turing-story-20260118-143052
```
)

Contents:

File	Description
`source-{slug}.{ext}`	Source files
`analysis.md`	Content analysis
`storyboard.md`	Storyboard with panel breakdown
`characters/characters.md`	Character definitions
`characters/characters.png`	Character reference sheet
`prompts/NN-{cover\|page}-[slug].md`	Generation prompts
`NN-{cover\|page}-[slug].png`	Generated images
`{topic-slug}.pdf`	Final merged PDF

输出目录:

comic/{topic-slug}/

Slug: 从主题提取的2-4个单词的短横线命名（例如
```
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

Language Handling

语言处理

Detection Priority:

```
--lang
```
flag (explicit)
EXTEND.md
```
language
```
setting
User's conversation language
Source content language

Rule: Use user's input language or saved language preference for ALL interactions:

Storyboard outlines and scene descriptions
Image generation prompts
User selection options and confirmations
Progress updates, questions, errors, summaries

Technical terms remain in English.

检测优先级:

```
--lang
```
参数（显式指定）
EXTEND.md 中的
```
language
```
设置
用户的对话语言
源内容语言

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

故事板大纲和场景描述
图片生成提示词
用户选择选项和确认信息
进度更新、问题、错误提示、总结

技术术语保留英文。

Workflow

工作流

Progress Checklist

进度检查清单

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

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

Flow

流程

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

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

Step Summary

步骤概览

Step	Action	Key Output
1.1	Load EXTEND.md preferences ⛔ BLOCKING if not found	Config loaded
1.2	Analyze content	`analysis.md`
1.3	Check existing directory	Handle conflicts
2	Confirm style, focus, audience, reviews	User preferences
3	Generate storyboard + characters	`storyboard.md` , `characters/`
4	Review outline (if requested)	User approval
5	Generate prompts	`prompts/*.md`
6	Review prompts (if requested)	User approval
7.1	Generate character sheet FIRST	`characters/characters.png`
7.2	Generate pages with character ref	`*.png` files
8	Merge to PDF	`{slug}.pdf`
9	Completion report	Summary

步骤	操作	核心输出
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	完成报告	总结

Step 7: Image Generation ⚠️ CRITICAL

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

Character reference is MANDATORY for visual consistency.

7.1 Generate character sheet first:

Backup rule: If

characters/characters.png

exists, rename to

characters/characters-backup-YYYYMMDD-HHMMSS.png

bash

undefined

为保证视觉一致性，必须使用角色参考图。

7.1 优先生成角色参考表:

备份规则: 如果

characters/characters.png

已存在，重命名为

characters/characters-backup-YYYYMMDD-HHMMSS.png

bash

undefined

Use Reference Sheet Prompt from characters/characters.md

npx -y bun ${SKILL_DIR}/../tuzi-image-gen/scripts/main.ts
--promptfiles characters/characters.md
--image characters/characters.png --ar 4:3


**Compress character sheet** (recommended):
Compress to reduce token usage when used as reference image:
- Use available image compression skill (if any)
- Or system tools: `pngquant`, `optipng`, `sips` (macOS)
- **Keep PNG format**, lossless compression preferred

**7.2 Generate each page WITH character reference**:

| Skill Capability | Strategy |
|------------------|----------|
| Supports `--ref` | Pass `characters/characters.png` with EVERY page |
| No `--ref` support | Prepend character descriptions to EVERY prompt file |

**Backup rules for page generation**:
- If prompt file exists: rename to `prompts/NN-{cover|page}-[slug]-backup-YYYYMMDD-HHMMSS.md`
- If image file exists: rename to `NN-{cover|page}-[slug]-backup-YYYYMMDD-HHMMSS.png`

```bash

npx -y bun ${SKILL_DIR}/../tuzi-image-gen/scripts/main.ts
--promptfiles characters/characters.md
--image characters/characters.png --ar 4:3


**压缩角色参考表**（推荐）:
压缩以减少作为参考图使用时的token消耗：
- 使用可用的图片压缩skill（如果有）
- 或系统工具: `pngquant`, `optipng`, `sips` (macOS)
- **保留PNG格式**，优先使用无损压缩

**7.2 生成每个页面时都使用角色参考图**:

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

**页面生成备份规则**:
- 如果提示词文件已存在：重命名为`prompts/NN-{cover|page}-[slug]-backup-YYYYMMDD-HHMMSS.md`
- 如果图片文件已存在：重命名为`NN-{cover|page}-[slug]-backup-YYYYMMDD-HHMMSS.png`

```bash

Example: ALWAYS include --ref for consistency

npx -y bun ${SKILL_DIR}/../tuzi-image-gen/scripts/main.ts
--promptfiles prompts/01-page-xxx.md
--image 01-page-xxx.png --ar 3:4
--ref characters/characters.png


**Full workflow details**: [references/workflow.md](references/workflow.md)

npx -y bun ${SKILL_DIR}/../tuzi-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](references/workflow.md)

EXTEND.md Paths ⛔ BLOCKING

EXTEND.md路径 ⛔ 阻塞步骤

CRITICAL: If EXTEND.md not found, MUST complete first-time setup before ANY other questions or steps. Do NOT proceed to content analysis, do NOT ask about art style, do NOT ask about tone — ONLY complete the preferences setup first.

Path	Location
`.tuzi-skills/tuzi-comic/EXTEND.md`	Project directory
`$HOME/.tuzi-skills/tuzi-comic/EXTEND.md`	User home

Result	Action
Found	Read, parse, display summary → Continue
Not found	⛔ BLOCKING: Run first-time setup ONLY (references/config/first-time-setup.md) → Complete and save EXTEND.md → Then continue

EXTEND.md Supports: Watermark | Preferred art/tone/layout | Custom style definitions | Character presets | Language preference

Schema: references/config/preferences-schema.md

关键提示：如果未找到EXTEND.md，必须先完成首次设置，才能执行其他任何操作或询问其他问题。不要继续进行内容分析，不要询问画风，不要询问基调——仅先完成偏好设置。

路径	位置
`.tuzi-skills/tuzi-comic/EXTEND.md`	项目目录
`$HOME/.tuzi-skills/tuzi-comic/EXTEND.md`	用户根目录

结果	操作
已找到	读取、解析、展示总结 → 继续
未找到	⛔ 阻塞: 仅执行首次设置 (references/config/first-time-setup.md) → 完成并保存EXTEND.md → 然后继续

EXTEND.md支持配置: 水印 | 偏好画风/基调/布局 | 自定义风格定义 | 角色预设 | 语言偏好

配置 schema: references/config/preferences-schema.md

References

参考资料

Core Templates:

analysis-framework.md - Deep content analysis
character-template.md - Character definition format
storyboard-template.md - Storyboard structure
ohmsha-guide.md - Ohmsha manga specifics

Style Definitions:

```
references/art-styles/
```
- Art styles (ligne-claire, manga, realistic, ink-brush, chalk)
```
references/tones/
```
- Tones (neutral, warm, dramatic, romantic, energetic, vintage, action)
```
references/presets/
```
- Presets with special rules (ohmsha, wuxia, shoujo)
```
references/layouts/
```
- Layouts (standard, cinematic, dense, splash, mixed, webtoon)

Workflow:

workflow.md - Full workflow details
auto-selection.md - Content signal analysis
partial-workflows.md - Partial workflow options

Config:

config/preferences-schema.md - EXTEND.md schema
config/first-time-setup.md - First-time setup
config/watermark-guide.md - Watermark configuration

核心模板:

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 schema
config/first-time-setup.md - 首次设置
config/watermark-guide.md - 水印配置

Page Modification

页面修改

Action	Steps
Edit	Update prompt file FIRST → `--regenerate N` → Regenerate PDF
Add	Create prompt at position → Generate with character ref → Renumber subsequent → Update storyboard → Regenerate PDF
Delete	Remove files → Renumber subsequent → Update storyboard → Regenerate PDF

IMPORTANT: When updating pages, ALWAYS update the prompt file (

prompts/NN-{cover|page}-[slug].md

) FIRST before regenerating. This ensures changes are documented and reproducible.

操作	步骤
编辑	优先更新提示词文件 → `--regenerate N` → 重新生成PDF
新增	在对应位置创建提示词 → 使用角色参考图生成 → 重命名后续文件 → 更新故事板 → 重新生成PDF
删除	移除文件 → 重命名后续文件 → 更新故事板 → 重新生成PDF

重要提示：更新页面时，重新生成前必须优先更新提示词文件（

prompts/NN-{cover|page}-[slug].md

）。这可以保证修改可记录、可复现。

Notes

注意事项

Image generation: 10-30 seconds per page
Auto-retry once on generation failure
Use stylized alternatives for sensitive public figures
Maintain style consistency via session ID
Step 2 confirmation required - do not skip
Steps 4/6 conditional - only if user requested in Step 2
Step 7.1 character sheet MUST be generated before pages - ensures consistency
Step 7.2 EVERY page MUST reference characters - use
```
--ref
```
or embed descriptions
Watermark/language configured once in EXTEND.md

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