baoyu-comic

Knowledge Comic Creator

複数のビジュアルスタイルでオリジナルの知識コミックを作成します。

使い方

/baoyu-comic posts/turing-story/source.md
/baoyu-comic  # then paste content

オプション

オプション	値
--style	classic（デフォルト）、dramatic、warm、sepia、vibrant、ohmsha、realistic、wuxia、shoujo、またはカスタムの説明
--layout	standard（デフォルト）、cinematic、dense、splash、mixed、webtoon
--aspect	3:4（デフォルト、縦向き）、4:3（横向き）、16:9（ワイドスクリーン）
--lang	auto（デフォルト）、zh、en、ja など

スタイル × レイアウト × アスペクト比は自由に組み合わせられます。カスタムスタイルは自然言語で説明できます。

コミックの全ページでアスペクト比は統一されます。

自動選択

コンテンツの特徴	スタイル	レイアウト
チュートリアル、ハウツー、初心者向け	ohmsha	webtoon
コンピューティング、AI、プログラミング	ohmsha	dense
1950年以前、古典、古代	sepia	cinematic
個人の物語、メンター	warm	standard
対立、ブレークスルー	dramatic	splash
ワイン、食、ビジネス、ライフスタイル、プロフェッショナル	realistic	cinematic
武術、武侠、仙侠、中国の歴史	wuxia	splash
ロマンス、恋愛、学校生活、友情、感動	shoujo	standard
伝記、バランス重視	classic	mixed

スクリプトディレクトリ

重要：すべてのスクリプトは、このスキルの scripts/ サブディレクトリにあります。

エージェントの実行手順：

1. この SKILL.md ファイルのディレクトリパスを SKILL_DIR として特定します
2. スクリプトのパス = ${SKILL_DIR}/scripts/<script-name>.ts
3. このドキュメント内のすべての ${SKILL_DIR} を実際のパスに置き換えます

スクリプト一覧：

スクリプト	用途
scripts/merge-to-pdf.ts	コミックのページを PDF に結合

ファイル構成

各セッションでは、コンテンツのスラッグを名前にした独立したディレクトリが作成されます。

comic/{topic-slug}/
├── source-{slug}.{ext}            # Source files (text, images, etc.)
├── analysis.md                    # Deep analysis results (YAML+MD)
├── storyboard-chronological.md    # Variant A (preserved)
├── storyboard-thematic.md         # Variant B (preserved)
├── storyboard-character.md        # Variant C (preserved)
├── characters-chronological/      # Variant A chars (preserved)
│   ├── characters.md
│   └── characters.png
├── characters-thematic/           # Variant B chars (preserved)
│   ├── characters.md
│   └── characters.png
├── characters-character/          # Variant C chars (preserved)
│   ├── characters.md
│   └── characters.png
├── storyboard.md                  # Final selected
├── characters/                    # Final selected
│   ├── characters.md
│   └── characters.png
├── prompts/
│   ├── 00-cover-[slug].md
│   └── NN-page-[slug].md
├── 00-cover-[slug].png
├── NN-page-[slug].png
└── {topic-slug}.pdf

スラッグの生成：

1. コンテンツから主なトピックを抽出します（2～4語、ケバブケース）
2. 例：「Alan Turing Biography」→ alan-turing-bio

競合の解決： comic/{topic-slug}/ がすでに存在する場合：

• タイムスタンプを追加します：{topic-slug}-YYYYMMDD-HHMMSS
• 例：turing-story が存在する場合 → turing-story-20260118-143052

ソースファイル： すべてのソースを source-{slug}.{ext} という名前でコピーします：

• source-biography.md、source-portrait.jpg、source-timeline.png など
• 複数のソースに対応しています：テキスト、画像、会話内のファイル

ワークフロー

ステップ 1：コンテンツを分析 → analysis.md

ソースコンテンツを読み、必要に応じて保存し、詳細に分析します。

実行内容：

1. ソースコンテンツを保存（まだファイルでない場合）：
   • ユーザーがファイルパスを指定した場合：そのまま使用します
   • ユーザーがコンテンツを貼り付けた場合：対象ディレクトリに source.md として保存します
2. ソースコンテンツを読みます
3. references/analysis-framework.md に従って詳細に分析します：
   • 対象読者の特定
   • 読者にとっての価値提案
   • 中核となるテーマと物語としての可能性
   • 主要人物とそのストーリーアーク
4. ソースの言語を検出します
5. 推奨ページ数を決定します：
   • 短編：5～8ページ
   • 中程度の複雑さ：9～15ページ
   • 詳細な伝記：16～25ページ
6. コンテンツの特徴を分析し、スタイルとレイアウトを提案します
7. analysis.md に保存します

analysis.md の形式：

---
title: "Alan Turing: Father of Computing"
topic: Biography
time_span: 1912-1954
source_language: en
user_language: zh
aspect_ratio: "3:4"
recommended_page_count: 12
---

## Target Audience

- **Primary**: Tech enthusiasts curious about computing history
- **Secondary**: Students learning about scientific breakthroughs
- **Tertiary**: General readers interested in biographical stories

## Value Proposition

What readers will gain:
1. Understanding of how modern computing was born
2. Emotional connection to a brilliant but tragic figure
3. Appreciation for the human cost of innovation

## Core Themes

| Theme | Narrative Potential | Visual Opportunity |
|-------|--------------------|--------------------|
| Genius vs. Society | High conflict, dramatic arcs | Contrast scenes |
| Code-breaking | Mystery, tension | Technical diagrams as art |
| Personal tragedy | Emotional depth | Intimate, somber panels |

## Key Figures & Story Arcs

### Alan Turing (Protagonist)
- **Arc**: Misunderstood genius → War hero → Tragic end
- **Visual identity**: Disheveled academic, intense eyes
- **Key moments**: Enigma breakthrough, arrest, final days

### Christopher Morcom (Catalyst)
- **Role**: Early friend whose death shaped Turing
- **Visual identity**: Youthful, bright
- **Key moments**: School friendship, sudden death

## Content Signals

- "biography" → classic + mixed
- "computing history" → ohmsha + dense
- "personal tragedy" → dramatic + splash

## Recommended Approaches

1. **Chronological** - follow life timeline (recommended for biography)
2. **Thematic** - organize by contributions (good for educational focus)
3. **Character-focused** - relationships drive narrative (good for emotional impact)

ステップ 2：ストーリーボードのバリエーションを 3 つ生成する

ナラティブのアプローチと推奨スタイルを組み合わせた、異なるバリエーションを 3 つ作成します。

バリエーション	ナラティブのアプローチ	推奨スタイル	レイアウト
A	時系列	sepia	cinematic
B	テーマ別	ohmsha	dense
C	登場人物重視	warm	standard

各バリエーションについて：

1. ストーリーボードを生成する（storyboard-{approach}.md）：

   • narrative_approach、recommended_style、recommended_layout、aspect_ratio を含む YAML フロントマター
   • 表紙のデザイン
   • 各ページ：レイアウト、パネルの内訳、ビジュアルプロンプト
   • ユーザーの希望する言語で記述
   • 参照：references/storyboard-template.md

2. 対応するキャラクターを生成する（characters-{approach}/）：

   • characters.md - 推奨スタイルに合わせたビジュアル仕様（ユーザーの希望する言語で記述）
   • characters.png - キャラクターのリファレンスシート
   • 参照：references/character-template.md

選択後も、すべてのバリエーションを参照用として保持します。

ステップ 3：すべてのオプションをユーザーに確認する

重要：AskUserQuestion を使って、すべてのオプションを 1 回の確認で提示します。複数回に分けて確認し、ワークフローを中断しないでください。

確認する項目を決定する：

質問	確認するタイミング
ストーリーボードのバリエーション	常に（必須）
ビジュアルスタイル	常に（必須）
言語	source_language ≠ user_language の場合のみ
アスペクト比	ユーザーがデフォルト以外を希望する可能性がある場合のみ（例：横向きのコンテンツ）

言語の扱い：

• ソース言語とユーザーの言語が同じ場合：ユーザーに伝えるだけにします（例：「コミックは中国語になります」）
• 異なる場合：使用する言語を尋ねます

すべてのストーリーボードとプロンプトは、ユーザーが選択または希望する言語で生成します。

アスペクト比の扱い：

• デフォルト：3:4（縦向き） - 標準的なコミック形式
• コンテンツに適している場合は 4:3（横向き）を提示します（例：パノラマシーン、技術図解）
• 映画的なコンテンツには 16:9（ワイドスクリーン）を提示します

AskUserQuestion の形式（すべての質問を含む例）：

Question 1 (Storyboard): Which storyboard variant?
- A: Chronological + sepia (Recommended)
- B: Thematic + ohmsha
- C: Character-focused + warm
- Custom

Question 2 (Style): Which visual style?
- sepia (Recommended from variant)
- classic / dramatic / warm / sepia / vibrant / ohmsha / realistic / wuxia
- Custom description

Question 3 (Language) - only if mismatch:
- Chinese (source material language)
- English (your preference)

Question 4 (Aspect) - only if relevant:
- 3:4 Portrait (Recommended)
- 4:3 Landscape
- 16:9 Widescreen

確認後：

1. 選択されたストーリーボードを storyboard.md にコピーします
2. 選択されたキャラクターを characters/ にコピーします
3. YAML フロントマターを、確認済みのスタイル、言語、aspect_ratio に更新します
4. スタイルがバリエーションの推奨スタイルと異なる場合：characters/characters.png を再生成します
5. ユーザーはファイルを直接編集して微調整できます

ステップ 4：画像を生成する

確認済みのストーリーボード、スタイル、アスペクト比を使います。

各ページ（表紙と各ページ）について：

1. プロンプトを prompts/NN-{cover|page}-[slug].md に保存します（ユーザーの希望する言語で記述）
2. 確認済みのスタイルとアスペクト比で画像を生成します
3. 生成後に進捗を報告します

画像生成スキルの選択：

• 利用可能な画像生成スキルを確認します
• 複数のスキルが利用可能な場合は、ユーザーの希望を尋ねます

キャラクターのリファレンスの扱い：

• スキルがリファレンス画像に対応している場合：characters/characters.png を渡します
• スキルがリファレンス画像に対応していない場合：characters/characters.md の内容をプロンプトに含めます

セッション管理： 画像生成スキルが --sessionId に対応している場合：

1. 一意のセッション ID を生成します：comic-{topic-slug}-{timestamp}
2. すべてのページで同じセッション ID を使用します
3. 生成画像間の視覚的一貫性を保ちます

ステップ 5：PDF にまとめる

すべての画像の生成後：

npx -y bun ${SKILL_DIR}/scripts/merge-to-pdf.ts <comic-dir>

すべてのページを全ページ画像として含む {topic-slug}.pdf を作成します。

ステップ 6：完了レポート

Comic Complete!
Title: [title] | Style: [style] | Pages: [count] | Aspect: [ratio] | Language: [lang]
Location: [path]
✓ analysis.md
✓ characters.png
✓ 00-cover-[slug].png ... NN-page-[slug].png
✓ {topic-slug}.pdf

ページの変更

初回生成後に、個別のページを変更できます。

1 ページを編集する

プロンプトを変更して、特定のページを再生成します。

1. 編集するページを特定します（例：03-page-enigma-machine.png）
2. 必要に応じて prompts/03-page-enigma-machine.md のプロンプトを更新します
3. 内容が大幅に変わる場合は、ファイル名のスラッグを更新します
4. 同じセッション ID とアスペクト比を使用して画像を再生成します
5. PDF を再生成します

新しいページの追加

指定した位置に新しいページを挿入します：

1. 挿入位置を指定します（例：3ページ目の後）
2. 適切なスラッグを付けて新しいプロンプトを作成します（例：04-page-bletchley-park.md）
3. 新しいページ画像を生成します（同じアスペクト比）
4. ファイルの番号を振り直します：以降のすべてのページの NN を 1 ずつ増やします
   • 04-page-tragedy.png → 05-page-tragedy.png
   • スラッグは変更しません
5. storyboard.md に新しいページのエントリーを追加します
6. PDF を再生成します

ページの削除

ページを削除し、番号を振り直します：

1. 削除するページを特定します（例：03-page-enigma-machine.png）
2. 画像ファイルとプロンプトファイルを削除します
3. ファイルの番号を振り直します：以降のすべてのページの NN を 1 ずつ減らします
   • 04-page-tragedy.png → 03-page-tragedy.png
   • スラッグは変更しません
4. storyboard.md からページのエントリーを削除します
5. PDF を再生成します

ファイル命名規則

ファイルには、読みやすさを向上させるため、内容が分かるスラッグを使用します：

NN-cover-[slug].png / NN-page-[slug].png
NN-cover-[slug].md / NN-page-[slug].md (in prompts/)

例：

• 00-cover-turing-story.png
• 01-page-early-life.png
• 02-page-cambridge-years.png
• 03-page-enigma-machine.png

スラッグのルール：

• ページのタイトル／内容から作成します（kebab-case）
• コミック内で一意である必要があります
• ページの内容が大幅に変更された場合は、スラッグも適宜更新します

番号の振り直し：

• 追加／削除後、対象ページの NN プレフィックスを更新します
• 内容が変更されない限り、スラッグは変更しません
• 欠番がないよう、連番を維持します

スタイル固有のガイドライン

Ohmsha スタイル（--style ohmsha）

教育マンガに関する追加要件：

• デフォルト：Doraemon のキャラクターをそのまま使用します - 新しいキャラクターを作成する必要はありません
  • 大雄（Nobita）：生徒役、好奇心旺盛な学習者
  • 哆啦A梦（Doraemon）：メンター役、ひみつ道具を使って概念を説明
  • 胖虎（Gian）：敵対者／課題役、障害や誤解を表現
  • 静香（Shizuka）：サポート役、確認のための質問をする
• カスタムキャラクターは、明示的に要求された場合にのみ使用します：--characters "Student:小明,Mentor:教授"
• 視覚的なメタファー（ひみつ道具、アクションシーン）を必ず使用します。会話する人物の顔だけを並べた描写は禁止です
• ページタイトルは物語風にし、「ページ X：トピック」の形式にはしません

参考：詳細なガイドラインについては、references/ohmsha-guide.md を参照してください。

参考資料

詳細なテンプレートとガイドラインは references/ ディレクトリにあります：

• analysis-framework.md - コミックへの翻案に向けたコンテンツの詳細分析
• character-template.md - キャラクター定義の形式と例
• storyboard-template.md - ストーリーボードの構成とコマの内訳
• ohmsha-guide.md - Ohmsha マンガスタイルの詳細
• styles/ - 詳細なスタイル定義
• layouts/ - 詳細なレイアウト定義

拡張機能のサポート

EXTEND.md を介して、カスタムスタイルと設定を利用できます。

確認するパス（優先順位順）：

1. .baoyu-skills/baoyu-comic/EXTEND.md（プロジェクト）
2. ~/.baoyu-skills/baoyu-comic/EXTEND.md（ユーザー）

見つかった場合は、ステップ 1 の前に読み込みます。拡張機能の内容はデフォルト設定より優先されます。