tuzi-comic

ナレッジコミッククリエイター

アートスタイルとトーンを自由に組み合わせて、オリジナルのナレッジコミックを作成します。

使い方

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

オプション

ビジュアルの要素

オプション	値	説明
--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 など	出力言語

ワークフローの一部のみ実行するオプション

オプション	説明
--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-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

自動選択

コンテンツの特徴に基づいて、デフォルトのアートスタイル、トーン、レイアウト（またはプリセット）が決まります。

コンテンツの特徴	おすすめ
チュートリアル、ハウツー、プログラミング、教育	ohmsha プリセット
1950年以前、古典、古代	realistic + vintage
個人的な物語、メンター	ligne-claire + warm
武術、武侠	wuxia プリセット
恋愛、学園生活	shoujo プリセット
伝記、バランスの取れた内容	ligne-claire + neutral

プリセットがおすすめされる場合：references/presets/{preset}.md を読み込み、すべての特別なルールを適用してください。

詳細：references/auto-selection.md

スクリプトディレクトリ

重要：すべてのスクリプトは、このスキルの 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}/

• スラッグ：トピックを表す 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}/../tuzi-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 に名前を変更します

# 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

ワークフローの詳細：references/workflow.md

EXTEND.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 がサポートする項目：透かし | 希望するアートスタイル／トーン／レイアウト | カスタムスタイル定義 | キャラクタープリセット | 言語設定

スキーマ：references/config/preferences-schema.md

参考資料

コアテンプレート：

• 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 のスキーマ
• config/first-time-setup.md - 初回セットアップ
• config/watermark-guide.md - 透かしの設定

ページの変更

アクション	手順
編集	最初にプロンプトファイルを更新 → --regenerate N → PDF を再生成
追加	該当位置にプロンプトを作成 → キャラクター参照を使って生成 → 後続のページを振り直す → ストーリーボードを更新 → PDF を再生成
削除	ファイルを削除 → 後続のページを振り直す → ストーリーボードを更新 → PDF を再生成

重要：ページを更新するときは、再生成の前に必ずプロンプトファイル（prompts/NN-{cover|page}-[slug].md）を更新してください。これにより、変更が記録され、再現可能になります。

備考

• 画像生成：1ページあたり10～30秒
• 生成に失敗した場合は、自動で1回再試行
• 公人を描く場合は、センシティブな内容を避けるため、様式化した代替表現を使用
• セッション ID を使用してスタイルの一貫性を維持
• ステップ2での確認が必須 - 省略しないでください
• ステップ4／6は条件付き - ステップ2でユーザーが希望した場合のみ実行
• ステップ7.1では、ページを作成する前に必ずキャラクターシートを生成 - 一貫性を確保します
• ステップ7.2では、すべてのページでキャラクターを参照することが必須 - --ref を使用するか、説明を埋め込んでください
• 透かしと言語は EXTEND.md で一度だけ設定