baoyu-comic

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

Hermes Agent のツールエコシステム向けに、baoyu-comic を改変したものです。

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

使用する場面

ユーザーがナレッジコミック、教育コミック、伝記コミック、チュートリアルコミックの作成を依頼した場合や、「知识漫画」「教育漫画」「Logicomix-style」などの用語を使用した場合に、このスキルを起動します。ユーザーはコンテンツ（テキスト、ファイルパス、URL、トピック）を提供し、必要に応じてアートスタイル、トーン、レイアウト、アスペクト比、言語を指定します。

参照画像

Hermes の image_generate ツールはプロンプトのみを受け付けます。テキストプロンプトとアスペクト比を指定すると、画像 URL が返されます。参照画像は受け付けません。ユーザーから参照画像が提供された場合は、特徴をテキストとして抽出し、各ページのプロンプトに含めてください。

受け付け：ユーザーがファイルパスを指定した場合は、そのパスを受け付けます（または会話内に画像が貼り付けられた場合）。

• ファイルパス：出所を記録するため、コミックの出力先と同じ場所に refs/NN-ref-{slug}.{ext} としてコピーします
• パスのない貼り付け画像：clarify を使ってユーザーにパスを尋ねるか、代替手段としてスタイルの特徴をテキストで聞き取ります
• 参照画像なし：このセクションを省略します

使用方法（参照画像ごと）：

用途	効果
style	スタイルの特徴（線の扱い、質感、雰囲気）を抽出し、各ページのプロンプト本文に追加します
palette	HEX カラーを抽出し、各ページのプロンプト本文に追加します
scene	シーンの構図や被写体に関するメモを抽出し、該当するページに追加します

参照画像がある場合は、各ページのプロンプトのフロントマターに記録します。

references:
  - ref_id: 01
    filename: 01-ref-scene.png
    usage: style
    traits: "muted earth tones, soft-edged ink wash, low-contrast backgrounds"

キャラクターの一貫性は、characters/characters.md（ステップ 3 で作成）に記述するテキストの説明によって保たれます。この説明は、各ページのプロンプトにインラインで埋め込まれます（ステップ 5）。ステップ 7.1 で生成する任意の PNG キャラクターシートは、人が確認するための成果物であり、image_generate への入力ではありません。

オプション

ビジュアル設定

オプション	値	説明
アート	ligne-claire（デフォルト）、manga、realistic、ink-brush、chalk、minimalist	アートスタイル／描画技法
トーン	neutral（デフォルト）、warm、dramatic、romantic、energetic、vintage、action	雰囲気／ムード
レイアウト	standard（デフォルト）、cinematic、dense、splash、mixed、webtoon、four-panel	コマの配置
アスペクト比	3:4（デフォルト、縦向き）、4:3（横向き）、16:9（ワイドスクリーン）	ページのアスペクト比
言語	auto（デフォルト）、zh、en、ja など	出力言語
参照画像	ファイルパス	スタイル／カラーパレットの特徴を抽出するために使用する参照画像（画像モデルには渡されません）。上記の参照画像を参照してください。

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

オプション	説明
ストーリーボードのみ	ストーリーボードのみを生成し、プロンプトと画像の生成を省略します
プロンプトのみ	ストーリーボードとプロンプトを生成し、画像の生成を省略します
画像のみ	既存のプロンプトディレクトリから画像を生成します
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 + 4 コマレイアウト	起承転結の構成、白黒＋差し色、棒人間のキャラクター

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

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

ファイル構成

出力ディレクトリ：comic/{topic-slug}/

• スラッグ：トピックから作成する 2～4 語のケバブケース（例：alan-turing-bio）
• 競合時：タイムスタンプを付加します（例：turing-story-20260118-143052）

内容：

ファイル	説明
source-{slug}.md	保存したソースコンテンツ（ケバブケースのスラッグは出力ディレクトリと一致します）
analysis.md	コンテンツ分析
storyboard.md	コマごとの構成を含む絵コンテ
characters/characters.md	キャラクターの定義
characters/characters.png	キャラクターの参照シート（image_generate からダウンロード）
prompts/NN-{cover|page}-[slug].md	生成プロンプト
NN-{cover|page}-[slug].png	生成画像（image_generate からダウンロード）
refs/NN-ref-{slug}.{ext}	ユーザー提供の参照画像（任意、出典の記録用）

言語の扱い

検出の優先順位：

1. ユーザーが指定した言語（明示的なオプション）
2. ユーザーの会話言語
3. ソースコンテンツの言語

ルール：すべてのやり取りで、ユーザーの入力言語を使用します。

• 絵コンテの概要とシーンの説明
• 画像生成プロンプト
• ユーザーが選択するオプションと確認
• 進捗状況の更新、質問、エラー、要約

技術用語は英語のままにします。

ワークフロー

進捗チェックリスト

Comic Progress:
- [ ] Step 1: Setup & Analyze
  - [ ] 1.1 Analyze content
  - [ ] 1.2 Check existing directory
- [ ] 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 character descriptions embedded in prompt)
- [ ] Step 8: Completion report

フロー

Input → Analyze → [Check Existing?] → [Confirm: Style + Reviews] → Storyboard → [Review?] → Prompts → [Review?] → Images → Complete

ステップの概要

ステップ	操作	主な出力
1.1	コンテンツを分析	analysis.md、source-{slug}.md
1.2	既存ディレクトリを確認	競合に対処
2	スタイル、焦点、対象者、レビューを確認	ユーザーの設定
3	絵コンテとキャラクターを生成	storyboard.md、characters/
4	概要をレビュー（要求された場合）	ユーザーの承認
5	プロンプトを生成	prompts/*.md
6	プロンプトをレビュー（要求された場合）	ユーザーの承認
7.1	キャラクターシートを生成（必要な場合）	characters/characters.png
7.2	ページを生成	*.png ファイル
8	完了レポート	要約

ユーザーへの質問

clarify ツールを使ってオプションを確認します。独立した質問は 1 つの questions 配列にまとめます（最大 5 件）。選択肢が先行する回答によって変わる質問は、別々に尋ねてください。Step 2 の質問の全リストについては、references/workflow.md を参照してください。

タイムアウト時の処理（重要）：clarify は、回答が "status": "unanswered" となった状態で "outcome": "timed_out" を返すことがあります。これは、すべての項目をデフォルトにすることへのユーザーの同意ではありません。

• デフォルトとして扱うのは、未回答の質問のみです。各質問はそれぞれ独立した同意確認事項です。
• 次のメッセージでは、ユーザーが訂正できるよう、デフォルトを目に見える形で提示してください。例："スタイル：clarify がタイムアウトしたため、ohmsha プリセットをデフォルトとして適用しました。変更する場合はお知らせください。" — デフォルトを報告しなければ、質問しなかった場合と区別がつきません。
• タイムアウトが 1 回発生しただけで、Step 2 を「すべてデフォルトを使用する」という 1 回の処理にまとめないでください。ユーザーが本当に不在であれば、5 つの質問すべてにも回答しないでしょう。しかし、戻ってきたときに、提示されたデフォルトなら訂正できますが、提示されていないデフォルトは訂正できません。

ステップ 7：画像生成

すべての画像描画には、Hermes に組み込まれている image_generate ツールを使用してください。このツールのスキーマが受け付けるのは prompt と aspect_ratio（landscape | portrait | square）のみで、ローカルファイルではなく URL を返します。そのため、生成したページやキャラクターシートはすべて出力ディレクトリにダウンロードする必要があります。

プロンプトファイルの要件（必須）：各画像の完全かつ最終版のプロンプトを、image_generate の呼び出し前に prompts/ 配下の独立したファイルに書き込んでください（命名規則：NN-{type}-[slug].md）。このプロンプトファイルが再現性を記録するためのものです。

アスペクト比の対応関係 — ストーリーボードの aspect_ratio フィールドは、次のように image_generate の形式に対応します。

ストーリーボードの比率	image_generate の形式
3:4、9:16、2:3	portrait
4:3、16:9、3:2	landscape
1:1	square

ダウンロード手順 — image_generate を呼び出すたびに、次の手順を実行してください。

1. ツールの結果から URL を読み取ります
2. 絶対パスを使用して画像データを取得します。例： curl -fsSL "<url>" -o /abs/path/to/comic/<slug>/NN-page-<slug>.png
3. 次のページに進む前に、指定した正確なパスにファイルが存在し、空でないことを確認します

-o のパスにシェルの CWD が維持されることを前提にしないでください。 ターミナルツールで永続化されるシェルの CWD は、バッチ間で変わることがあります（セッションの期限切れ、TERMINAL_LIFETIME_SECONDS、cd の失敗により誤ったディレクトリにいる場合など）。curl -o relative/path.png は、CWD が変わっていてもエラーなしでファイルが別の場所に保存されるため、見落としやすい危険な記述です。必ず -o に完全な絶対パスを指定するか、ターミナルツールに workdir=<abs path> を渡してください。 2026年4月の事例：10ページのコミックの 06〜09 ページが、バッチ 3 でバッチ 2 の古い CWD を引き継いだため、comic/<slug>/ ではなくリポジトリのルートに保存されました。その後、エージェントはファイルが存在しない場所にあると何ターンも主張し続けました。

7.1 キャラクターシート — 繰り返し登場するキャラクターがいる複数ページのコミックでは、characters/characters.png に生成してください（アスペクト比は landscape）。シンプルなプリセット（例：ミニマルな四コマ）や 1 ページのコミックでは省略します。characters/characters.md のプロンプトファイルは、image_generate を呼び出す前に存在していなければなりません。生成した PNG は人間による確認用の成果物（ユーザーがキャラクターデザインを目で確認できるようにするもの）であり、後の再生成や手動でのプロンプト編集のための参考資料です。Step 7.2 の処理には使用しません。ページのプロンプトは、characters/characters.md のテキストによる説明をもとに Step 5 で作成済みです。image_generate は画像を視覚的な入力として受け付けられません。

7.2 ページ — image_generate を呼び出す前に、各ページのプロンプトが prompts/NN-{cover|page}-[slug].md にすでに保存されていなければなりません。image_generate はプロンプトのみを入力として受け付けるため、Step 5 で characters/characters.md に記載されたキャラクターの説明をすべてのページプロンプトに埋め込むことで、キャラクターの一貫性を保ちます。7.1 で PNG シートを生成するかどうかにかかわらず、埋め込みは一律に行います。PNG は確認と再生成の補助としてのみ使用します。

バックアップのルール：既存の prompts/…md および …png ファイルは、再生成する前に -backup-YYYYMMDD-HHMMSS サフィックスを付けて名前を変更してください。

手順の詳細（分析、ストーリーボード、レビューのゲート、再生成バリエーション）については、references/workflow.md を参照してください。

参考資料

コアテンプレート：

• analysis-framework.md - コンテンツの詳細分析
• character-template.md - キャラクター定義の形式
• storyboard-template.md - ストーリーボードの構成
• ohmsha-guide.md - オーム社の漫画に関する詳細

スタイル定義：

• references/art-styles/ - アートスタイル（ligne-claire、manga、realistic、ink-brush、chalk、minimalist）
• references/tones/ - トーン（neutral、warm、dramatic、romantic、energetic、vintage、action）
• references/presets/ - 特別なルールを含むプリセット（ohmsha、wuxia、shoujo、concept-story、four-panel）
• references/layouts/ - レイアウト（standard、cinematic、dense、splash、mixed、webtoon、four-panel）

ワークフロー：

• workflow.md - ワークフローの詳細
• auto-selection.md - コンテンツのシグナル分析
• partial-workflows.md - ワークフローの一部を実行するオプション

ページの変更

操作	手順
編集	まずプロンプトファイルを更新 → 画像を再生成 → 新しいPNGをダウンロード
追加	該当位置にプロンプトを作成 → キャラクターの説明を埋め込んで生成 → 後続の番号を振り直す → ストーリーボードを更新
削除	ファイルを削除 → 後続の番号を振り直す → ストーリーボードを更新

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

注意点

• 画像生成：1ページあたり10～30秒。失敗した場合は自動で1回再試行します
• image_generate が返すURLは必ずローカルのPNGとしてダウンロードしてください。後続のツール（およびユーザーによるレビュー）では、一時的なURLではなく出力ディレクトリ内のファイルが必要です
• curl -o では絶対パスを使用してください。バッチ間で永続シェルのCWDに依存しないでください。気づきにくい落とし穴として、ファイルが誤ったディレクトリに保存され、後続の ls で目的のパスを確認しても何も見つからないことがあります。「ダウンロード手順」のステップ7を参照してください
• 公人を扱う場合は、センシティブにならないよう様式化した代替表現を使用してください
• ステップ2での確認が必須です。省略しないでください
• ステップ4と6は条件付きです。ステップ2でユーザーが依頼した場合にのみ実行してください
• ステップ7.1のキャラクターシート：複数ページの漫画では推奨、シンプルなプリセットでは任意です。PNGは確認・再生成の補助として使用します。ページのプロンプト（ステップ5で作成）はPNGではなく、characters/characters.md のテキストの説明を使用します。image_generate は画像を視覚的な入力として受け付けません
• シークレットを除去してください。出力ファイルを書き込む前に、ソースコンテンツにAPIキー、トークン、認証情報が含まれていないか確認してください