mcpField
C
canghe-comic

canghe-comic

github.com/freestylefly创意与媒体470578 次安装20 周前更新
代码仓库

关于 canghe-comic

用于将文章和其他内容制作成知识漫画的技能,可按画风、基调、版式和语言配置输出。工作流涵盖分镜、角色设定、图像生成及 PDF 合并,并支持只执行部分步骤或重新生成指定页面。

主要功能

  1. 01多种画风、基调与版式
  2. 02按内容信号自动选择风格
  3. 03分镜与角色设定生成
  4. 04分阶段执行或重生成页面
  5. 05漫画页面合并为 PDF

适用场景

  1. 01把教程改编成漫画
  2. 02为传记或个人故事制作漫画
  3. 03生成并调整特定页面
  4. 04将漫画页面合并为 PDF

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/freestylefly/canghe-skills --skill canghe-comic

安装后在 Claude Code 中输入/canghe-comic确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

references/
analysis-framework.md
auto-selection.md
base-prompt.md
character-template.md
ohmsha-guide.md
partial-workflows.md
storyboard-template.md
references/art-styles/
chalk.md
ink-brush.md
ligne-claire.md
manga.md
realistic.md
references/config/
first-time-setup.md
preferences-schema.md
watermark-guide.md
references/layouts/
cinematic.md
dense.md
mixed.md
splash.md
standard.md
webtoon.md
references/presets/
ohmsha.md
shoujo.md
wuxia.md
references/tones/
action.md
dramatic.md
energetic.md
neutral.md
romantic.md
vintage.md

详细介绍

知识漫画创作器

通过灵活组合画风与基调,创作原创知识漫画。

用法

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

选项

视觉维度
选项值说明
--artligne-claire(默认)、manga、realistic、ink-brush、chalk画风/绘制技法
--toneneutral(默认)、warm、dramatic、romantic、energetic、vintage、action情绪/氛围
--layoutstandard(默认)、cinematic、dense、splash、mixed、webtoon分格布局
--aspect3:4(默认,竖版)、4:3(横版)、16:9(宽屏)页面宽高比
--langauto(默认)、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-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

自动选择

内容信号决定默认画风、基调和布局(或预设):

内容信号推荐选项
教程、操作指南、编程、教育内容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 (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}/../canghe-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}/../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

EXTEND.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 支持:水印 | 偏好的艺术风格/语气/布局 | 自定义风格定义 | 角色预设 | 语言偏好

架构:references/config/preferences-schema.md

参考资料

核心模板:

风格定义:

  • 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)

工作流:

配置:

页面修改

操作步骤
编辑先更新提示词文件 → --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