baoyu-infographic

インフォグラフィック生成

2 つの軸：レイアウト（情報構造）× スタイル（ビジュアルの美しさ）。レイアウトとスタイルは自由に組み合わせられます。

ユーザー入力ツール

このスキルがユーザーに入力を求める場合は、次のツール選択ルールに従ってください（優先順位順）。

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 上にあり、ログイン済みの場合は、baoyu-image-gen --provider codex-cli 経由で実行してください（推奨）。利用できない場合は、同梱のラッパーを直接呼び出してください。詳細、パラメーター、ランタイムの検出手順は 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）は例です。同じルールに従って、ローカル環境にある同等のツールに置き換えてください。

参照画像

ユーザーは、スタイル、配色、構成、被写体の参考として画像を提供できます。

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

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

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

使用方法	効果
direct	参照画像としてファイルをバックエンドに渡します
style	スタイルの特徴（線の表現、テクスチャ、雰囲気）を抽出し、プロンプト本文に追加します
palette	画像からカラーコードを抽出し、プロンプト本文に追加します

参照画像がある場合は prompts/infographic.md のフロントマターに記録します：

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

生成時：

• 参照する各ファイルがディスク上に存在することを確認します
• usage: direct で、選択したバックエンドが参照画像を受け付ける場合（例：baoyu-image-gen の --ref）→ バックエンドの参照用パラメーターでファイルを渡します
• それ以外の場合 → 抽出した style／palette の特徴をプロンプトのテキストに埋め込みます

確認ポリシー

デフォルトの動作：生成前に確認します。

• 明示的なスキルの呼び出し、ファイルパス、キーワードショートカットとの一致、EXTEND.md のデフォルト設定、およびドキュメントに記載されたデフォルトの組み合わせは、推奨入力としてのみ扱います。いずれも確認を省略する許可にはなりません。
• ユーザーが組み合わせ、アスペクト比、言語、バックエンドの選択を確認するまでは、ステップ 5 またはステップ 6 を開始しないでください。
• 確認を省略できるのは、現在のリクエストで省略が明示されている場合に限ります。例：--no-confirm、「直接生成」、「確認不要」、「確認をスキップ」、「デフォルトで生成」、または同等の表現。
• 確認を明示的に省略した場合は、生成前の次のユーザー向けアップデートで、想定した組み合わせ、アスペクト比、言語、バックエンドを伝えてください。

オプション

オプション	値
--layout	21 種類（Layout Gallery を参照）、デフォルト：bento-grid
--style	22 種類（Style Gallery を参照）、デフォルト：craft-handmade
--aspect	名前付き：landscape（16:9）、portrait（9:16）、square（1:1）。カスタム：任意の W:H 比（例：3:4、4:3、2.35:1）
--lang	en、zh、ja など
--no-confirm	ユーザーが確認なしの直接生成を明示的に求めた場合に限り、ステップ 4 をスキップします
--ref <files...>	スタイル／配色／構成／被写体の参考にする画像のファイルパス

レイアウト一覧（21）

レイアウト	最適な用途
linear-progression	タイムライン、プロセス、チュートリアル
binary-comparison	A 対 B、ビフォーアフター、メリットとデメリット
comparison-matrix	複数要素の比較
hierarchical-layers	ピラミッド、優先度のレベル
tree-branching	カテゴリー、分類体系
hub-spoke	関連項目を持つ中心的な概念
structural-breakdown	分解図、断面図
bento-grid	複数のトピック、概要（デフォルト）
iceberg	表面的な側面と隠れた側面
bridge	問題と解決策
funnel	コンバージョン、フィルタリング
isometric-map	空間的な関係
dashboard	指標、KPI
periodic-table	カテゴリー別のコレクション
comic-strip	物語、連続した出来事
story-mountain	プロット構成、緊張感の起伏
jigsaw	相互につながる要素
venn-diagram	重なり合う概念
winding-roadmap	道のり、マイルストーン
circular-flow	サイクル、繰り返されるプロセス
dense-modules	高密度なモジュール、情報量の多いガイド

詳細な定義は references/layouts/<layout>.md にあります。

スタイル一覧（22）

スタイル	説明
craft-handmade	手描き、ペーパークラフト（デフォルト）
claymation	3D の粘土フィギュア、ストップモーション
kawaii	日本風のかわいらしさ、パステルカラー
storybook-watercolor	柔らかな彩色、幻想的な雰囲気
chalkboard	黒板に描いたチョーク画
cyberpunk-neon	ネオンの光、未来的
bold-graphic	コミック風、網点
aged-academia	ヴィンテージの科学、セピア調
corporate-memphis	フラットなベクター、鮮やかな色彩
technical-schematic	設計図、エンジニアリング
origami	折り紙、幾何学的
pixel-art	レトロな 8 ビット
ui-wireframe	グレースケールのインターフェースモックアップ
subway-map	交通路線図
ikea-manual	ミニマルな線画
knolling	整然と並べた俯瞰図
lego-brick	おもちゃのブロックを組み立てた表現
pop-laboratory	設計図のグリッド、座標マーカー、実験室のような精密さ
morandi-journal	手描きの落書き、温かみのあるモランディカラー
retro-pop-grid	1970 年代のレトロポップアート、スイスグリッド、太い輪郭線
hand-drawn-edu	マカロンカラーのパステル、手描きの揺らぎ、棒人間
retro-popup-pop	レトロなポップアップ風コラージュ、ヴィンテージ UI、太い輪郭線、フラットなポップカラー

詳細な定義は references/styles/<style>.md にあります。

おすすめの組み合わせ

コンテンツの種類	レイアウト + スタイル
タイムライン／歴史	linear-progression + craft-handmade
ステップごとの説明	linear-progression + ikea-manual
A 対 B	binary-comparison + corporate-memphis
階層	hierarchical-layers + craft-handmade
重なり	venn-diagram + craft-handmade
コンバージョン	funnel + corporate-memphis
サイクル	circular-flow + craft-handmade
技術的な内容	structural-breakdown + technical-schematic
指標	dashboard + corporate-memphis
教育	bento-grid + chalkboard
道のり	winding-roadmap + storybook-watercolor
カテゴリー	periodic-table + bold-graphic
製品ガイド	dense-modules + morandi-journal
技術ガイド	dense-modules + pop-laboratory
トレンドガイド	dense-modules + retro-pop-grid
レトロポップガイド	dense-modules + retro-popup-pop
教育用の図	hub-spoke + hand-drawn-edu
プロセスチュートリアル	linear-progression + hand-drawn-edu

デフォルトの組み合わせ：bento-grid + craft-handmade（フォールバック時のおすすめに限ります。確認ポリシーに従い、デフォルトがステップ 4 を省略することはありません）。

キーワードショートカット

ユーザーの入力に次のキーワードが含まれる場合、対応するレイアウトをステップ 3 の最優先のおすすめとして使用し、記載されたスタイルをステップ 3 のリストの上位に配置します。一致したキーワードについては、コンテンツに基づくレイアウトの推定をスキップします。Prompt Notes がある場合は、ステップ 5 のプロンプトに追加します。

ユーザーキーワード	レイアウト	おすすめスタイル	デフォルトのアスペクト比	プロンプトの補足
高密度信息大图 / 高密度情報の大型図 / high-density-info	dense-modules	morandi-journal、pop-laboratory、retro-pop-grid、retro-popup-pop	縦向き	—
信息图 / インフォグラフィック / infographic	bento-grid	craft-handmade	横向き	ミニマリスト：すっきりしたキャンバス、十分な余白、複雑な背景テクスチャなし。シンプルな漫画風の要素とアイコンのみ。

出力構成

infographic/{topic-slug}/
├── source-{slug}.{ext}
├── analysis.md
├── structured-content.md
├── prompts/infographic.md
└── infographic.png

スラッグ：トピックを表す 2～4 語の kebab-case。競合する場合：-YYYYMMDD-HHMMSS を追加します。

基本原則

• ソースデータを忠実に保持します。要約や言い換えはしません（ただし、出力に含める前に、認証情報、API キー、トークン、シークレットはすべて削除します）。
• コンテンツを構成する前に、学習目標を定義します。
• 視覚的なコミュニケーション（見出し、ラベル、視覚要素）を意識して構成します。

ワークフロー

ステップ 1：セットアップと分析

1.1 設定の読み込み（EXTEND.md）

優先順位に従って EXTEND.md を確認します。最初に見つかったファイルを使用します。

優先度	パス	対象範囲
1	.baoyu-skills/baoyu-infographic/EXTEND.md	プロジェクト
2	${XDG_CONFIG_HOME:-$HOME/.config}/baoyu-skills/baoyu-infographic/EXTEND.md	XDG
3	$HOME/.baoyu-skills/baoyu-infographic/EXTEND.md	ユーザーホーム

結果	アクション
見つかった	読み込み、解析し、1 行で要約を表示します
見つからない	AskUserQuestion でユーザーに確認します（references/config/first-time-setup.md を参照）

EXTEND.md で設定可能な項目：推奨レイアウト／スタイル、デフォルトのアスペクト比、言語設定、推奨画像バックエンド、カスタムスタイル定義。

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

1.2 コンテンツの分析 → analysis.md

1. ソースコンテンツを保存します（ファイルパスまたは貼り付け → source.md）
   • バックアップルール：source.md が存在する場合、source-backup-YYYYMMDD-HHMMSS.md に名前を変更します
2. トピック、データの種類、複雑さ、トーン、対象読者を分析します
3. ソースの言語とユーザーの言語を検出します
4. ユーザーの入力からデザイン指示を抽出します
5. 分析結果を保存します
   • バックアップルール：analysis.md が存在する場合、analysis-backup-YYYYMMDD-HHMMSS.md に名前を変更します

詳しい形式については、references/analysis-framework.md を参照してください。

ステップ 2：構造化コンテンツの生成 → structured-content.md

コンテンツをインフォグラフィックの構成に変換します。

1. タイトルと学習目標
2. 次の項目を含むセクション：主要概念、コンテンツ（原文のまま）、視覚要素、テキストラベル
3. データポイント（すべての統計／引用を正確にコピー）
4. ユーザーからのデザイン指示

ルール：Markdown のみ。新しい情報を追加しません。データを忠実に保持します。出力から認証情報やシークレットをすべて削除します。

詳しい形式については、references/structured-content-template.md を参照してください。

ステップ 3：組み合わせの提案

3.1 まずキーワードショートカットを確認する：ユーザーの入力がキーワードショートカットの表にあるキーワードと一致する場合、対応するレイアウトを最優先のおすすめとして使用し、対応するスタイルをおすすめの上位に配置します。コンテンツに基づくレイアウトの推定はスキップします。

3.2 それ以外の場合、次の項目に基づいて、レイアウト×スタイルの組み合わせを 3～5 件提案します。

• データ構造 → 適切なレイアウト
• コンテンツのトーン → 適切なスタイル
• 対象読者の期待
• ユーザーからのデザイン指示

ステップ 4：オプションを確認する

必須ゲート：このステップは、確認ポリシーに従って必須です。ここでユーザーが確認する（または現在のリクエストで --no-confirm などにより明示的に確認を省略する）まで、ステップ 5～6 を開始できません。

このファイルの冒頭にあるユーザー入力ツールのルールに従って、以下の質問への確認をユーザーに求めます（実行環境が複数の質問に対応している場合は 1 回にまとめ、対応していない場合は優先順位順に 1 つずつ尋ねます）。

優先度	質問	条件	選択肢
1	組み合わせ	常に	理由を添えたレイアウト×スタイルの組み合わせを 3 つ以上
2	縦横比	常に	名前付きプリセット（横長／縦長／正方形）またはカスタムの W:H 比率（例：3:4、4:3、2.35:1）
3	言語	ソースの言語 ≠ ユーザーの言語の場合のみ	テキストコンテンツの言語
4	画像バックエンド	## Image Generation Tools のルールのステップ 3 で質問が必要な場合のみ（実行環境ネイティブのツールがなく、ネイティブではないバックエンドが複数ある場合、または preferred_image_backend: ask の場合）	利用可能なバックエンド

ステップ 5：プロンプトを生成する → prompts/infographic.md

バックアップルール：prompts/infographic.md が存在する場合は、prompts/infographic-backup-YYYYMMDD-HHMMSS.md に名前を変更します。

以下を組み合わせます。

1. references/layouts/<layout>.md のレイアウト定義
2. references/styles/<style>.md のスタイル定義
3. references/base-prompt.md の基本テンプレート
4. ステップ 2 の構造化コンテンツ
5. 確認済みの言語によるすべてのテキスト

{{ASPECT_RATIO}} の縦横比の解決方法：

• 名前付きプリセット → 比率文字列：横長→16:9、縦長→9:16、正方形→1:1
• カスタムの W:H 比率 → そのまま使用します（例：3:4、4:3、2.35:1）

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

1. このファイルの冒頭にある ## Image Generation Tools のルールに従って、バックエンドを解決します。
2. バックエンドを呼び出す前に、最終プロンプト全体が prompts/infographic.md に保存されていることを確認します（ステップ 5 ですでに書き込まれています）。このファイルは再現性を記録するものです。
3. 既存ファイルを確認する：生成前に infographic.png が存在するか確認します
   • 存在する場合：infographic-backup-YYYYMMDD-HHMMSS.png に名前を変更します
4. 選択したバックエンドを、プロンプトファイルと出力先パスを指定して呼び出します。
   • codex-imagegen の呼び出し：ルールによって codex-imagegen が選択された場合は、呼び出しの仕様（推奨される baoyu-image-gen --provider codex-cli の経路、実行環境のラッパー検出、パラメーターに関する注意事項、標準出力のスキーマ、バッチ処理の動作）について、references/codex-imagegen.md を参照してください。
5. 失敗した場合は、1 回だけ自動で再試行します。

テキスト修正ポリシー：

• ラベル、見出し、コールアウト、データ値など、描画されたテキストに誤字、文字化け、読みにくさ、または視覚的な弱さがある場合、コードでビットマップを修正しないでください。
• テキスト修正のために再生成する場合は、新しいプロンプトファイルと新しい出力先パスを使用し、問題のある候補を比較用に残します。
• 後処理は、テキストや全体の構成を変更しないトリミング、リサイズ、圧縮、形式変換に限られます。

ステップ 7：出力の概要

トピック、レイアウト、スタイル、縦横比、言語、画像バックエンド、出力先パス、作成ファイルを報告します。

参考資料

• references/analysis-framework.md - 分析手法
• references/structured-content-template.md - コンテンツ形式
• references/base-prompt.md - プロンプトテンプレート
• references/layouts/<layout>.md - 21 種類のレイアウト定義
• references/styles/<style>.md - 21 種類のスタイル定義

設定の変更

EXTEND.md は、Step 1.1 で最初に一致したパスにあります。変更方法は 3 つあります。

• 直接編集する — EXTEND.md を開いてフィールドを変更します。スキーマ全体は references/config/preferences-schema.md を参照してください。
• 対話形式で再設定する — EXTEND.md を削除するか、「reconfigure baoyu-infographic 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 — 毎回バックエンドを確認します。
  • preferred_layout: dense-modules、preferred_style: morandi-journal、preferred_aspect: portrait、language: zh — Step 3 の推奨内容と Step 4 のデフォルト設定を変更します（確認ポリシーに従い、これらの設定が Step 4 を省略することはありません）。