Back to Details

canghe-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
/canghe-comic posts/turing-story/source.md
/canghe-comic article.md --art manga --tone warm
/canghe-comic  # then paste content
bash
/canghe-comic posts/turing-story/source.md
/canghe-comic article.md --art manga --tone warm
/canghe-comic  # 然后粘贴内容

Options

选项

Visual Dimensions

视觉维度

OptionValuesDescription
--art
ligne-claire (default), manga, realistic, ink-brush, chalkArt style / rendering technique
--tone
neutral (default), warm, dramatic, romantic, energetic, vintage, actionMood / atmosphere
--layout
standard (default), cinematic, dense, splash, mixed, webtoonPanel 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

部分工作流选项

OptionDescription
--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
清线均匀线条，平涂色彩，欧洲漫画传统（如《丁丁历险记》《Logicomix》）
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:
PresetEquivalentSpecial 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-claireneutral, warmdramatic, vintage, energeticromantic, action
manganeutral, romantic, energetic, actionwarm, dramaticvintage
realisticneutral, warm, dramatic, vintageactionromantic, energetic
ink-brushneutral, dramatic, action, vintagewarmromantic, energetic
chalkneutral, warm, energeticvintagedramatic, action, romantic
Details: references/auto-selection.md
艺术风格✓✓ 最佳适配✓ 可适配✗ 避免组合
ligne-claireneutral, warmdramatic, vintage, energeticromantic, action
manganeutral, romantic, energetic, actionwarm, dramaticvintage
realisticneutral, warm, dramatic, vintageactionromantic, energetic
ink-brushneutral, dramatic, action, vintagewarmromantic, energetic
chalkneutral, warm, energeticvintagedramatic, action, romantic
详情：references/auto-selection.md

Auto Selection

自动选择

Content signals determine default art + tone + layout (or preset):
Content SignalsRecommended
Tutorial, how-to, programming, educationalohmsha preset
Pre-1950, classical, ancientrealistic + vintage
Personal story, mentorligne-claire + warm
Martial arts, wuxiawuxia preset
Romance, school lifeshoujo preset
Biography, balancedligne-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:
  1. Determine this SKILL.md file's directory path as 
    SKILL_DIR
  2. Script path = 
    ${SKILL_DIR}/scripts/<script-name>.ts
  3. Replace all 
    ${SKILL_DIR}
    in this document with the actual path
Script Reference:
ScriptPurpose
scripts/merge-to-pdf.ts
Merge comic pages into PDF
重要提示：所有脚本均位于本技能的 
scripts/
子目录中。
Agent执行说明:
  1. 确定本SKILL.md文件的目录路径为 
    SKILL_DIR
  2. 脚本路径 = 
    ${SKILL_DIR}/scripts/<script-name>.ts
  3. 将本文档中所有 
    ${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:
FileDescription
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:
  1. --lang
    flag (explicit)
  2. EXTEND.md 
    language
    setting
  3. User's conversation language
  4. 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.
检测优先级:
  1. --lang
    参数（显式指定）
  2. EXTEND.md 中的 
    language
    设置
  3. 用户对话使用的语言
  4. 源内容的语言
规则: 所有交互均使用用户输入语言或已保存的语言偏好：
  • 分镜大纲与场景描述
  • 图像生成提示词
  • 用户选择选项与确认信息
  • 进度更新、问题、错误提示、总结
专业术语保留英文。

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
漫画制作进度:
- [ ] 步骤1: 配置与分析
  - [ ] 1.1 偏好设置（EXTEND.md） ⛔ 阻塞项
    - [ ] 已找到 → 加载偏好设置 → 继续
    - [ ] 未找到 → 执行首次设置 → 必须完成后才能进行其他步骤
  - [ ] 1.2 内容分析, 1.3 检查已有文件
- [ ] 步骤2: 确认 - 风格与选项 ⚠️ 必填项
- [ ] 步骤3: 生成分镜脚本 + 角色设定
- [ ] 步骤4: 审阅大纲（可选）
- [ ] 步骤5: 生成提示词
- [ ] 步骤6: 审阅提示词（可选）
- [ ] 步骤7: 生成图像 ⚠️ 必须有角色参考图
  - [ ] 7.1 先生成角色参考图 → characters/characters.png
  - [ ] 7.2 生成页面时必须添加 --ref characters/characters.png
- [ ] 步骤8: 合并为PDF
- [ ] 步骤9: 完成报告

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
输入 → [偏好设置] ─┬─ 已找到 → 继续
                       │
                       └─ 未找到 → 首次设置 ⛔ 阻塞项
                                      │
                                      └─ 完成设置 → 保存EXTEND.md → 继续
                                                                              │
        ┌─────────────────────────────────────────────────────────────────────┘
        ↓
分析 → [检查已有文件?] → [确认: 风格 + 审阅选项] → 分镜脚本 → [需要审阅?] → 提示词 → [需要审阅?] → 图像 → PDF → 完成

Step Summary

步骤摘要

StepActionKey Output
1.1Load EXTEND.md preferences ⛔ BLOCKING if not foundConfig loaded
1.2Analyze content
analysis.md
1.3Check existing directoryHandle conflicts
2Confirm style, focus, audience, reviewsUser preferences
3Generate storyboard + characters
storyboard.md
, 
characters/
4Review outline (if requested)User approval
5Generate prompts
prompts/*.md
6Review prompts (if requested)User approval
7.1Generate character sheet FIRST
characters/characters.png
7.2Generate pages with character ref
*.png
files
8Merge to PDF
{slug}.pdf
9Completion reportSummary
步骤操作关键输出
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

使用characters/characters.md中的参考图提示词

npx -y bun ${SKILL_DIR}/../canghe-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}/../canghe-image-gen/scripts/main.ts
--promptfiles characters/characters.md
--image characters/characters.png --ar 4:3

**压缩角色参考图**（推荐）:
压缩以减少作为参考图时的令牌消耗：
- 使用可用的图像压缩技能（若有）
- 或系统工具: `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`

```bash

Example: ALWAYS include --ref for consistency

示例: 为保证一致性，始终添加--ref参数

npx -y bun ${SKILL_DIR}/../canghe-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}/../canghe-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.
PathLocation
.canghe-skills/canghe-comic/EXTEND.md
Project directory
$HOME/.canghe-skills/canghe-comic/EXTEND.md
User home
ResultAction
FoundRead, 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，必须先完成首次设置，之后才能进行任何其他提问或步骤。不得直接进行内容分析，不得询问艺术风格或基调 —— 仅能先完成偏好设置。
路径位置
.canghe-skills/canghe-comic/EXTEND.md
项目目录
$HOME/.canghe-skills/canghe-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

页面修改

ActionSteps
EditUpdate prompt file FIRST → 
--regenerate N
→ Regenerate PDF
AddCreate prompt at position → Generate with character ref → Renumber subsequent → Update storyboard → Regenerate PDF
DeleteRemove 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中配置一次