baoyu-comic

ナレッジコミック作成ツール

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

ユーザー入力ツール

このスキルがユーザーに質問する場合は、次の優先順位に従ってツールを選択してください。

1. 組み込みのユーザー入力ツールを優先してください。現在のエージェントランタイムが公開している AskUserQuestion、request_user_input、clarify、ask_user など、またはそれらに相当するツールを使用します。
2. 代替手段：該当するツールがない場合は、番号付きのプレーンテキストメッセージを出力し、各質問への回答として選択した番号や回答を返信するようユーザーに依頼します。
3. まとめて質問：ツールが1回の呼び出しで複数の質問に対応している場合は、該当する質問をすべてまとめて呼び出します。1回に1つの質問しかできない場合は、優先順位に従って1つずつ質問します。

以下の AskUserQuestion に関する具体例は参考例です。他のランタイムでは、ローカルの同等ツールに置き換えてください。

画像生成ツール

このスキルで画像をレンダリングする必要がある場合は、次の順序でバックエンドを選択してください。

1. 現在のリクエストによる指定 — ユーザーが現在のメッセージで特定のバックエンドを指定している場合は、それを使用します。
2. 保存済みの設定 — EXTEND.md で preferred_image_backend に現在利用可能なバックエンドが設定されている場合は、それを使用します。
3. 自動選択（設定が auto、未設定、または指定されたバックエンドが利用できない場合）：
   • Codex（imagegen） — まず、利用可能なスキルとツールの一覧を確認します。imagegen という名前のスキルが一覧にある場合は、Codex 内で実行しているため、必ず Skill ツールを使い、skill: "imagegen" を指定して呼び出します。保存済みプロンプトファイルの内容を渡し、出力パスとアスペクト比は Codex の imagegen 独自の引数で指定します。Codex の imagegen は、そのランタイムの公式ラスターバックエンドであり、ユーザーが別の preferred_image_backend を明示的に固定していない限り、baoyu-image-gen などのネイティブではないスキルより優先されます。
   • codex exec 経由の Codex（codex-imagegen） — 現在のランタイムにネイティブの imagegen スキルがなく、codex CLI が PATH 上にあり、codex login が有効な場合は、baoyu-image-gen --provider codex-cli を経由させます（推奨）。baoyu-image-gen が利用できない場合は、同梱のラッパーを直接呼び出します。詳細、パラメーター、およびランタイムの検出手順は references/codex-imagegen.md にあります。この分岐を選択した場合に限り、このファイルを読み込んでください。
   • Cursor（GenerateImage） — ランタイムでネイティブの GenerateImage ツールが利用できる場合は、Cursor 内で実行しているため、Codex の imagegen と同様に、ネイティブではないスキルより優先されます。次の2つの制約に注意してください。（a）アスペクト比のパラメーターがないため、description として渡すプロンプト文に、目標のアスペクト比や寸法を明記します。（b）出力ディレクトリを指定できず、ツールが管理する場所に保存されるため、生成後にスキルが想定する出力パス（例：outputs/.../NN-xxx.png）へファイルをコピーまたは移動します。参照画像は reference_image_paths に指定します。
   • その他のランタイムネイティブツール — ランタイムで別のネイティブ画像ツール（例：Hermes の image_generate）が利用できる場合も、同様に使用します。
   • それ以外で、ネイティブではないバックエンドが1つだけインストールされている場合（例：baoyu-image-gen）は、それを使用します。
   • それ以外の場合（ランタイムネイティブツールがなく、ネイティブではないバックエンドが複数ある場合）は、他の初回質問とまとめて、ユーザーに1度だけ確認します。
4. 利用可能なものがない場合は、その旨をユーザーに伝え、どう進めるか尋ねます。

⛔ ラスタ画像生成の代わりに、SVG、HTML、canvas、その他コードベースのレンダリングを使ってはいけません。 Codex の imagegen の説明では、出力がリポジトリネイティブのコードやベクターではなく「ビットマップアセットであるべき場合」に使用するものとされています。手順3でラスターバックエンドを特定できない場合は、手順4に進んでユーザーに確認してください。SVGを黙って出力したり、インラインの <svg> マークアップを書いたり、代替として HTML/CSS のアートを作成したりしてはいけません。呼び出し元のスキルがこのルールを適用することを決めているため、記事やセクションが「図解のように見える」場合も同様です。 ⛔ 生成済みのビットマップに上描きして、レンダリングされたテキストを修正してはいけません。 ImageMagick、Pillow、Canvas、SVG、HTML/CSS、OCR スクリプトなどのプログラムによるオーバーレイを使って、生成済みのコミックページ内にあるセリフ、効果音、パネルラベル、その他のテキストを覆ったり、書き換えたり、消去したり、線を引いたり、置き換えたりしないでください。テキストが間違っている、または不明瞭な場合は、修正したプロンプトで再生成するか、画像内のテキストを減らすかなくしてページを描き直すか、どの不完全な候補を残すかユーザーに尋ねてください。

preferred_image_backend: ask を設定すると、利用可能なバックエンドにかかわらず、実行のたびにステップ3のプロンプトが表示されます。ピン留めされたバックエンドを変更するには、以下の ## Changing Preferences セクションを参照してください。

プロンプトファイルの必須要件（厳守）：バックエンドを呼び出す前に、各画像の完全な最終プロンプトを prompts/ 内の独立したファイル（命名規則：NN-{type}-[slug].md）に書き込んでください。バックエンドにはプロンプトファイル、またはその内容を渡します。このファイルは再現性の記録となり、プロンプトを再生成せずにバックエンドを切り替えられます。

上記の具体的なツール名（imagegen、GenerateImage、image_generate、baoyu-image-gen）は例です。同じルールに従い、ローカル環境で相当するものに置き換えてください。

バッチ生成ポリシー

現在の生成グループに含まれるすべてのプロンプトファイルを保存して検証した後は、原則として画像をバッチで生成してください。

優先順位：

1. 選択したバックエンドにネイティブのバッチ／複数タスク用インターフェースがある場合は、それを使用します。各タスクには、それぞれのプロンプトファイル、出力パス、アスペクト比、セッション ID、直接参照画像を設定してください。
2. ネイティブのバッチインターフェースがないものの、ランタイムがツール呼び出しの並列実行に対応している場合は、一度に generation_batch_size 件まで実行します。デフォルトは 4 です。現在のメッセージ内の明示的なユーザー要求（--batch-size 4 や「並行4张一起生成」など）があれば、EXTEND.md より優先されます。
3. ネイティブのバッチインターフェースも、ツール呼び出しの並列実行も利用できない場合は、順次生成します。

ルール：

• まずワークフローの依存関係に従ってください。参照画像として使用するページを生成する前に、characters/characters.png を生成してください。
• 選択したページのプロンプトファイルがすべてディスク上に揃うまで、最初のページのバッチ生成を開始しないでください。
• 失敗した項目は一度だけ再試行し、成功した項目は再生成しないでください。
• 画像のレンダリングを並列化する目的だけでサブエージェントを使用しないでください。サブエージェントは、別個のプロンプトの反復や創作の検討にのみ使用してください。

参照画像

ユーザーは、アートスタイル、パレット、シーン構成、被写体を指定するために参照画像を提供できます。これは自動生成されるキャラクターシート（ステップ7.1）とは別のものです。両方を併用できます。ユーザーの参照画像は作品全体の見た目を指定し、キャラクターシートは繰り返し登場するキャラクターの同一性を維持します。

受け取り：--ref <files...> を使用するか、ユーザーが会話内でファイルパスを指定する、または画像を貼り付けた場合に受け付けます。

• ファイルパスが指定された場合 → コミックの出力先と同じ場所に refs/NN-ref-{slug}.{ext} としてコピーします
• パスのない画像が貼り付けられた場合 → 上記の「ユーザー入力ツール」のルールに従ってユーザーにパスを尋ねるか、代替手段としてスタイルの特徴を口頭で抽出します
• 参照画像がない場合 → このセクションをスキップします

使用モード（参照画像ごと）：

使用方法	効果
direct	各ページ（または選択したページ）で、参照画像としてファイルをバックエンドに渡します
style	スタイルの特徴（線の表現、質感、雰囲気）を抽出し、各ページのプロンプト本文に追加します
palette	16進カラーコードを抽出し、各ページのプロンプト本文に追加します

参照画像がある場合は、各ページのプロンプトのフロントマターに記録してください：

references:
  - ref_id: 01
    filename: 01-ref-scene.png
    usage: direct

生成時：

• 各参照ファイルがディスク上に存在することを確認します
• usage: direct で、選択したバックエンドが複数の参照画像を受け付ける場合は、キャラクターシート（ステップ7.2）とユーザーの参照画像の両方を、バックエンドの参照パラメーターで渡します。ペイロードのエラーを防ぐため、ステップ7.1の指示に従って、あらかじめ画像を圧縮してください
• バックエンドが参照画像を1枚しか受け付けない場合は、繰り返し登場するキャラクターがいるページではキャラクターシートを優先し、代わりにユーザー参照画像の特徴をプロンプト本文に埋め込みます
• style／palette を使用する場合は、抽出した特徴をすべてのページのプロンプトテキストに埋め込みます（バックエンドの機能にかかわらず適用します）

オプション

ビジュアルの設定

オプション	値	説明
--art	ligne-claire（デフォルト）、manga、realistic、ink-brush、chalk、minimalist	アートスタイル／描画技法
--tone	neutral（デフォルト）、warm、dramatic、romantic、energetic、vintage、action	雰囲気／ムード
--layout	standard（デフォルト）、cinematic、dense、splash、mixed、webtoon、four-panel	コマの配置
--aspect	3:4（デフォルト、縦長）、4:3（横長）、16:9（ワイドスクリーン）	ページのアスペクト比
--lang	auto（デフォルト）、zh、en、ja など	出力言語
--ref <files...>	ファイルパス	スタイル／パレット／シーンの参考として、すべてのページに適用する参照画像です。上記の参照画像を参照してください。
--batch-size <n>	1-8	今回の実行における一時的なページ生成バッチサイズです。デフォルト：EXTEND.md の generation_batch_size。設定がない場合は 4 です。

部分ワークフローのオプション

オプション	説明
--storyboard-only	ストーリーボードのみを生成し、プロンプトと画像をスキップします
--prompts-only	ストーリーボードとプロンプトを生成し、画像をスキップします
--images-only	既存のプロンプトディレクトリから画像を生成します
--regenerate N	指定したページのみを再生成します（例：3 または 2,5,8）

詳細：references/partial-workflows.md

アート、トーン、プリセットのカタログ

• アートスタイル（6 種類）：ligne-claire、manga、realistic、ink-brush、chalk、minimalist。詳しい定義は references/art-styles/<style>.md にあります。

• トーン（7 種類）：neutral、warm、dramatic、romantic、energetic、vintage、action。詳しい定義は references/tones/<tone>.md にあります。

• プレーンなアートスタイル＋トーンに加えて特別なルールを持つプリセット（5 種類）：

  プリセット	同等の設定	特徴
  ohmsha	manga + neutral	視覚的な比喩、会話する人物のみの構図は避ける、ガジェットの登場
  wuxia	ink-brush + action	気の表現、戦闘のビジュアル、雰囲気重視
  shoujo	manga + romantic	装飾要素、目のディテール、ロマンチックな展開
  concept-story	manga + warm	視覚的なシンボル体系、成長の軌跡、会話とアクションのバランス
  four-panel	minimalist + neutral + four-panel layout	起承転合の構成、白黒＋差し色、棒人間のキャラクター

  詳しいルールは references/presets/<preset>.md にあります。プリセットが選択されたら、このファイルを読み込んでください。

• 互換性マトリックスとコンテンツの特徴 → プリセットの表は、references/auto-selection.md にあります。ステップ 2 で組み合わせを推奨する前に、このファイルを読んでください。

スクリプトディレクトリ

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

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

1. この SKILL.md ファイルのディレクトリパスを {baseDir} として特定します
2. スクリプトのパス = {baseDir}/scripts/<script-name>.ts
3. このドキュメント内の {baseDir} をすべて実際のパスに置き換えます
4. ${BUN_X} のランタイムを解決します：bun がインストールされている場合は bun、npx が利用可能な場合は npx -y bun、それ以外の場合は bun のインストールを提案します

スクリプトのリファレンス：

スクリプト	用途
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
  - [ ] 7.1 Generate character sheet (if needed) → characters/characters.png
  - [ ] 7.2 Generate pages (with --ref if character sheet exists)
- [ ] 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：画像の生成

セッションごとに一度だけ、先頭にある ## Image Generation Tools のルールに従ってバックエンドを選択します。バックエンドがリポジトリのスキル（例：baoyu-image-gen）の場合は、その SKILL.md を読み、スクリプトではなく、記載されているインターフェースを使用してください。

codex-imagegen の呼び出し：ルールによって codex-imagegen が選択された場合は、呼び出しの仕様（推奨される baoyu-image-gen --provider codex-cli のパス、実行時のラッパー検出、パラメーターの注記、標準出力のスキーマ、バッチ処理の仕様 — 1 回の呼び出しにつき n=1 のため、ページのバッチごとにページ単位でラッパー呼び出しを 1 回ずつ実行する必要があります）について、references/codex-imagegen.md を参照してください。

7.1 キャラクターシート — コミックが複数ページで、キャラクターが繰り返し登場する場合は生成します（characters/characters.png、アスペクト比 4:3）。シンプルなプリセット（例：ミニマリストな 4 コマ）や 1 ページのコミックでは省略します。--ref で使用する前に JPEG に圧縮します（macOS では sips -s format jpeg -s formatOptions 80 …、その他の環境では pngquant --quality=65-80 …）。これによりペイロードの失敗を防ぎます。バックエンドを呼び出す前に、characters/characters.md のプロンプトファイルが存在している必要があります。

7.2 ページ — バックエンドを呼び出す前に、各ページのプロンプトが prompts/NN-{cover|page}-[slug].md に保存されている必要があります。このファイルが再現性の記録となります。戦略はキャラクターシートの有無によって異なります：

キャラクターシート	バックエンドの --ref	戦略
あり	対応	各ページでシートを --ref として渡す
あり	非対応	各プロンプトファイルの先頭にキャラクターの説明を追加する
省略	—	説明をすべてプロンプトに含める

実行戦略：必要な場合は、まずキャラクターシートを生成します。次に、保存済みのプロンプトファイルから選択したページのタスクリストを作成し、## Batch Generation Policy に従ってページをバッチで実行します。まずバックエンドのネイティブバッチ機能を使用し、次に実行時の並列ツール呼び出しを使用し、最後の手段としてのみ逐次実行します。--regenerate N と --images-only にも、選択した既存のプロンプトに対して同じバッチ処理ルールを適用します。

バックアップのルール：既存の prompts/…md および …png ファイルは、再生成の前に -backup-YYYYMMDD-HHMMSS のサフィックスを付けて名前を変更します。アスペクト比はストーリーボードに従います（デフォルトは 3:4。プリセットで上書きされる場合があります）。

--ref の失敗からの復旧：シートを圧縮して再試行します。それでも失敗する場合は、--ref を外し、キャラクターの説明をプロンプトのテキストに含めます。

分析、ストーリーボード、レビューチェックポイント、再生成の各パターンを含む、手順を追ったワークフロー全体については、references/workflow.md を参照してください。

EXTEND.md のパス ⛔ ブロッキング

EXTEND.md が見つからない場合、初回セットアップは必須です。コンテンツ分析やスタイル／トーンに関する質問を行う前に、完了してください。

優先度	パス	スコープ
1	.baoyu-skills/baoyu-comic/EXTEND.md	プロジェクト
2	$HOME/.baoyu-skills/baoyu-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 - オーム社マンガの詳細

スタイル定義：

• references/art-styles/ - 画風（リーニュ・クレール、マンガ、リアル調、墨絵、チョーク、ミニマリスト）
• references/tones/ - トーン（ニュートラル、温かみのある、ドラマチック、ロマンチック、エネルギッシュ、ビンテージ、アクション）
• references/presets/ - 特別なルールを含むプリセット（オーム社、武侠、少女漫画、コンセプトストーリー、4コマ）
• references/layouts/ - レイアウト（標準、シネマティック、密集、スプラッシュ、混合、ウェブトゥーン、4コマ）

ワークフロー：

• 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 で一度だけ設定

設定の変更

EXTEND.md は .baoyu-skills/baoyu-comic/EXTEND.md（プロジェクト）または ~/.baoyu-skills/baoyu-comic/EXTEND.md（ユーザー）にあります。変更方法は 3 つあります。

• 直接編集する — EXTEND.md を開いてフィールドを変更します。スキーマ全体については、references/config/preferences-schema.md を参照してください。
• 対話形式で再設定する — EXTEND.md を削除するか、「reconfigure baoyu-comic preferences」／「重新配置」と依頼します。次回の実行時に初回セットアップが再度開始されます。
• よくある 1 行編集：
  • preferred_image_backend: auto — デフォルトです。実行環境ネイティブのツールが優先され、利用可能なバックエンドが 1 つだけならそれにフォールバックします。ネイティブ以外のバックエンドが複数ある場合のみ確認します。
  • preferred_image_backend: codex-imagegen — Codex 内蔵のものに固定します。
  • preferred_image_backend: baoyu-image-gen — baoyu-image-gen スキルに固定します。
  • preferred_image_backend: ask — 毎回バックエンドを確認します。
  • generation_batch_size: 4 — バックエンド／実行環境がバッチ生成または並列生成に対応している場合に、同時にレンダリングするページ画像のデフォルト数です。
  • watermark.enabled: true、preferred_art、preferred_tone、preferred_layout、language — 自動選択のデフォルトと外観上の設定を変更します。