baoyu-image-cards

画像カードシリーズ生成ツール

複雑なコンテンツを、目を引く画像カードシリーズに分解します。複数のスタイルから選べます。

ユーザー入力ツール

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

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-imagine などのネイティブではないスキルより優先されます。
   • その他のランタイムネイティブツール — ランタイムが別のネイティブ画像ツール（例：Hermes image_generate）を公開している場合は、同じ方法で使用します。
   • それ以外の場合、インストールされているネイティブではないバックエンドが 1 つだけなら（例：baoyu-imagine）、それを使用します。
   • それ以外の場合（ネイティブ画像ツールがなく、ネイティブではないバックエンドが複数ある場合）は、他の初回質問とまとめて、ユーザーに一度だけ確認します。
4. 利用可能なバックエンドがない場合は、その旨をユーザーに伝え、次にどう進めるか尋ねます。

⛔ ラスター画像の生成を SVG、HTML、canvas、その他のコードベースの描画で代用してはいけません。 Codex imagegen の説明には、「出力をリポジトリネイティブなコードやベクターではなく、ビットマップアセットにする場合」に使用すると記載されています。手順 3 でラスター画像のバックエンドを決定できない場合は、手順 4 に進んでユーザーに確認してください。黙って SVG を出力したり、インラインの <svg> マークアップを書いたり、代わりに HTML/CSS アートを作成したりしてはいけません。対象が「図解のような」内容であっても同様です。このルールを呼び出すスキルが、ラスター画像を必要とするとすでに判断しています。

⛔ 生成済みのビットマップに上描きして、レンダリングされたテキストを修正してはいけません。 ImageMagick、Pillow、Canvas、SVG、HTML/CSS、OCR スクリプト、その他のプログラムを使って、生成済み画像カード内のタイトル、本文、タグ、その他のテキストを覆う、書き換える、消す、縁取りする、置き換えるといった処理を行ってはいけません。テキストに誤りがある、または不明瞭な場合は、修正したプロンプトで再生成するか、カード内のテキストを減らしたレイアウトに切り替えるか、不完全な候補のうちどれを残すかユーザーに尋ねてください。

preferred_image_backend: ask を設定すると、利用可能なバックエンドの有無にかかわらず、実行のたびに手順 3 でユーザーに確認します。固定するバックエンドは、以下の「## 設定の変更」セクションに従って変更します。

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

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

バッチ生成ポリシー

現在の生成グループのプロンプトファイルをすべて保存して検証したら、デフォルトでは画像をバッチで生成します。

優先順位：

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

ルール：

• image-1 アンカーチェーンに従います。まず image 1 を生成し、その後、image 1 を参照画像として画像 2 以降をバッチ生成します。
• 選択したバッチのすべてのプロンプトファイルがディスク上に存在するまでは、バッチを開始しないでください。
• 失敗した項目のみ、成功した項目を再生成せずに一度だけ再試行します。
• 画像のレンダリングを並列化する目的だけでサブエージェントを使用しないでください。サブエージェントは、個別のプロンプト反復またはクリエイティブな検討にのみ使用してください。

確認ポリシー

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

• 明示的なスキルの呼び出し、ファイルパス、一致するシグナル／プリセット、EXTEND.md のデフォルトは、推奨内容の入力としてのみ扱います。いずれも確認を省略する権限にはなりません。
• ユーザーが Step 2 を完了するまで、Step 3 を開始しないでください。
• 現在のリクエストで、たとえば --yes、「直接生成」、「不用确认」、「跳过确认」、「按默认出图」など、確認を省略するよう明示されている場合に限り、確認を省略します。
• 確認を明示的に省略した場合は、生成前の次のユーザー向け更新で、前提とする戦略／スタイル／レイアウト／パレット／枚数／バックエンドを伝えます。

言語

質問、進捗、エラー、完了の概要では、ユーザーの言語を使用します。技術的なトークン（スタイル名、ファイルパス、コード）は英語のままにします。

オプション

オプション	説明
--style <name>	ビジュアルスタイル（以下の「スタイル」を参照）
--layout <name>	情報レイアウト（以下の「レイアウト」を参照）
--palette <name>	色の上書き：macaron / warm / neon
--preset <name>	スタイル + レイアウト + 任意のパレットの短縮指定（以下の「プリセット」を参照。プリセットごとのプロンプト断片は references/style-presets.md にあります）
--ref <files...>	シリーズのアンカーとして image 1 に適用する参照画像
--batch-size <n>	この実行で一時的に使用する生成バッチサイズ。デフォルトは EXTEND.md の generation_batch_size、設定がない場合は 4 です。1～8 の範囲に制限されます。
--yes	非対話型：すべての確認を省略し、EXTEND.md または組み込みのデフォルトを使用して、推奨プラン（Path A）を自動確認します

寸法

独立した 3 つの設定を自由に組み合わせられます：

寸法	制御対象	オプション
スタイル	ビジュアルの美しさ（線、装飾、レンダリング）	12 種類のスタイル（以下の「スタイル」を参照）
レイアウト	情報構造（密度、配置）	8 種類のレイアウト（以下の「レイアウト」を参照）
パレット（任意）	スタイルのデフォルトカラーを置き換える色の指定	macaron / warm / neon（以下の「パレット」を参照）

例：--style notion --layout dense は、知的なナレッジカードを作成します。--palette macaron を追加すると、notion のレンダリングルールを変えずに色合いを柔らかくできます。--preset は、スタイル + レイアウト（+ 任意のパレット）を短縮指定するものです。

パレットの動作：--palette を指定しない場合 → スタイルに組み込まれたカラーを使用します。--palette <name> を指定した場合 → 色のみを上書きし、レンダリングルールは変更しません。一部のスタイルでは default_palette が定義されています（例：sketch-notes のデフォルトは macaron）。

スタイル（12）

スタイル	説明
cute（デフォルト）	甘くてかわいらしい、ガーリーな雰囲気
fresh	清潔感があり、爽やかでナチュラル
warm	居心地がよく、親しみやすい雰囲気
bold	インパクトが強く、人目を引く
minimal	極めてすっきりとしていて、洗練された雰囲気
retro	ヴィンテージ感があり、懐かしくてトレンディ
pop	鮮やかでエネルギッシュ、目を引く
notion	ミニマルな手描き線画、知的な雰囲気
chalkboard	黒板にカラフルなチョークで描いた、教育的な雰囲気
study-notes	青ペンと赤の注釈、黄色の蛍光ペンを使った、リアルな手書き写真風
screen-print	大胆なポスターアート、網点のテクスチャ、限定色、象徴的なストーリーテリング
sketch-notes	手描きの教育用インフォグラフィック、温かみのあるクリーム色にマカロンパステル、揺らぎのある線

スタイルごとの仕様：references/presets/<style>.md。

レイアウト（8）

レイアウト	説明
sparse（デフォルト）	1～2項目、インパクトを最大化
balanced	3～4項目、標準
dense	5～8項目、ナレッジカード風
list	列挙／ランキング（4～7項目）
comparison	左右に並べた対比
flow	プロセス／タイムライン（3～6ステップ）
mindmap	中心から放射状に広がる構成（4～8分岐）
quadrant	四象限／円形のセクション

レイアウト仕様：references/elements/canvas.md。

パレット（任意の上書き）

描画ルール（線の処理、テクスチャ）を保ったまま、スタイルの色を置き換えます。

パレット	背景	ゾーンカラー	アクセント	雰囲気
macaron	温かみのあるクリーム色 #F5F0E8	ブルー #A8D8EA、ラベンダー #D5C6E0、ミント #B5E5CF、ピーチ #F8D5C4	コーラル #E8655A	柔らかく、教育的
warm	ソフトピーチ #FFECD2	オレンジ #ED8936、テラコッタ #C05621、ゴールデン #F6AD55、ローズ #D4A09A	シエンナ #A0522D	アースカラー、居心地のよい雰囲気
neon	ダークパープル #1A1025	シアン #00F5FF、マゼンタ #FF00FF、グリーン #39FF14、ピンク #FF6EC7	イエロー #FFFF00	エネルギッシュで未来的

パレットの仕様：references/palettes/<palette>.md。

プリセット（スタイル＋レイアウトのショートカット）

シナリオ別にまとめた、すぐに使える組み合わせです。--preset <name>を使うか、ステップ 2 で提案してください。

ナレッジと学習：

プリセット	スタイル	レイアウト	最適な用途
knowledge-card	notion	dense	実用的な知識カード、概念の解説
checklist	notion	list	チェックリスト、ランキング
concept-map	notion	mindmap	概念図、知識のつながり
swot	notion	quadrant	SWOT 分析、四象限
tutorial	chalkboard	flow	チュートリアルの手順、操作の流れ
classroom	chalkboard	balanced	授業ノート、知識の解説
study-guide	study-notes	dense	学習ノート、試験の要点
hand-drawn-edu	sketch-notes	flow	手描きチュートリアル、フロー図解
sketch-card	sketch-notes	dense	手描きの知識カード
sketch-summary	sketch-notes	balanced	手描きのまとめ、図解付きノート

ライフスタイルと共有：

プリセット	スタイル	レイアウト	最適な用途
cute-share	cute	balanced	ガーリーな共有、日常のおすすめ
girly	cute	sparse	甘い表紙、雰囲気重視
cozy-story	warm	balanced	暮らしの物語、気持ちの共有
product-review	fresh	comparison	製品の比較、レビュー
nature-flow	fresh	flow	健康に関する流れ、自然をテーマにした内容

インパクトと意見：

プリセット	スタイル	レイアウト	最適な用途
warning	bold	list	失敗を避けるためのガイド、重要な注意
versus	bold	comparison	賛否の比較
clean-quote	minimal	sparse	名言、ミニマルな表紙
pro-summary	minimal	balanced	専門的なまとめ、ビジネス向けコンテンツ

トレンドとエンターテインメント：

プリセット	スタイル	レイアウト	最適な用途
retro-ranking	retro	list	レトロなランキング、名作の振り返り
throwback	retro	balanced	懐かしさを共有
pop-facts	pop	list	楽しい豆知識
hype	pop	sparse	インパクトのある表紙、驚きの共有

ポスターとエディトリアル：

プリセット	スタイル	レイアウト	最適な用途
poster	screen-print	sparse	ポスター風の表紙、映画評・書評
editorial	screen-print	balanced	意見記事、文化評論
cinematic	screen-print	comparison	映画の比較、ドラマチックな演出

プロンプト断片の定義の全容：references/style-presets.md。

自動選択

コンテンツの特徴に最適な組み合わせを選びます。キーワードが含まれる最初の行が優先されます。一致するものがない場合は、cute-share を選びます。

ソース内の特徴	スタイル	レイアウト	推奨プリセット
beauty, fashion, cute, girl, pink	cute	sparse/balanced	cute-share, girly
health, nature, fresh, organic	fresh	balanced/flow	product-review, nature-flow
life, story, emotion, warm	warm	balanced	cozy-story
warning, important, must, critical	bold	list/comparison	warning, versus
professional, business, elegant	minimal	sparse/balanced	clean-quote, pro-summary
classic, vintage, traditional	retro	balanced	throwback, retro-ranking
fun, exciting, wow, amazing	pop	sparse/list	hype, pop-facts
knowledge, concept, productivity, SaaS	notion	dense/list	knowledge-card, checklist
education, tutorial, learning, classroom	chalkboard	balanced/dense	tutorial, classroom
notes, handwritten, study guide, realistic	study-notes	dense/list/mindmap	study-guide
movie, poster, opinion, editorial, cinematic	screen-print	sparse/comparison	poster, editorial, cinematic
hand-drawn, infographic, workflow, 手绘, 图解	sketch-notes	flow/balanced/dense	hand-drawn-edu, sketch-card, sketch-summary

スタイル × レイアウトのマトリックス

適合度（✓✓ 強く推奨、✓ 適合、✗ 避ける）。ユーザーがデフォルト以外の組み合わせを選び、相性がよくない場合に注意を促すために使用します。

	sparse	balanced	dense	list	comparison	flow	mindmap	quadrant
cute	✓✓	✓✓	✓	✓✓	✓	✓	✓	✓
fresh	✓✓	✓✓	✓	✓	✓	✓✓	✓	✓
warm	✓✓	✓✓	✓	✓	✓✓	✓	✓	✓
bold	✓✓	✓	✓	✓✓	✓✓	✓	✓	✓✓
minimal	✓✓	✓✓	✓✓	✓	✓	✓	✓	✓
retro	✓✓	✓✓	✓	✓✓	✓	✓	✓	✓
pop	✓✓	✓✓	✓	✓✓	✓✓	✓	✓	✓
notion	✓✓	✓✓	✓✓	✓✓	✓✓	✓✓	✓✓	✓✓
chalkboard	✓✓	✓✓	✓✓	✓✓	✓	✓✓	✓✓	✓
study-notes	✗	✓	✓✓	✓✓	✓	✓	✓✓	✓
screen-print	✓✓	✓✓	✗	✓	✓✓	✓	✗	✓✓
sketch-notes	✓	✓✓	✓✓	✓✓	✓	✓✓	✓✓	✓

アウトラインの方針

特徴の異なる3つのアプローチがあり、それぞれ構造の異なるアウトラインを生成します。ワークフローでは1つを推奨します。Path Cでは3つすべてを生成し、ユーザーが選べるようにします。

方針	コンセプト	最適な用途	構成
A — ストーリー重視	個人的な体験を軸にし、感情への訴求を優先	レビュー、個人的な共有、変化	フック → 課題 → 発見 → 体験 → 結論
B — 情報重視	価値を最初に提示し、効率よく情報を伝える	チュートリアル、比較、チェックリスト	核となる結論 → 情報カード → メリット／デメリット → 推奨
C — ビジュアル重視	視覚的なインパクトを中心に据え、テキストを最小限にする	美的要素を重視する製品、ライフスタイル、ムードコンテンツ	メイン画像 → 詳細ショット → ライフスタイルシーン → CTA

参照画像

ユーザー提供の参照画像は、内部の「image-1 をアンカーにする」連鎖（Step 3）とは別個のもので、これに加えて使用します。

取り込み：--ref <files...> または会話に貼り付けられたパスを使用します。

• ファイルパス → refs/NN-ref-{slug}.{ext} にコピーします
• パスなしで貼り付けられた画像 → パスを尋ねるか、代替手段としてスタイルの特徴をテキストで抽出します

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

使用方法	効果
direct	ファイルをバックエンドに渡します（通常は画像 1 のみに渡すため、アンカーが連鎖を通じて引き継がれます）
style	スタイルの特徴を抽出し、各カードのプロンプト本文に追加します
palette	16 進カラーコードを抽出し、各カードのプロンプト本文に追加します

影響を受ける各カードのプロンプトのフロントマターに参照画像を記録します：

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

生成時に、ファイルが存在することを確認します。usage: direct を指定した画像 1 と参照画像を受け付けるバックエンドの場合は、バックエンドの参照パラメーター経由で渡します（これが連鎖のアンカーになります）。画像 2 以降では、Step 3 に従って引き続き image-1 を --ref として使用します。競合する指示を避けるため、ユーザーの参照画像を重ねて追加してはいけません。style／palette の場合は、抽出した特徴をすべてのプロンプトに埋め込みます。

ファイル構成

image-cards/{topic-slug}/
├── source-{slug}.{ext}
├── analysis.md
├── outline-strategy-{a,b,c}.md    # Path C only
├── outline.md
├── prompts/NN-{type}-{slug}.md
├── NN-{type}-{slug}.png
└── refs/                          # only if --ref used

スラッグ：2～4 語のケバブケースにします。「AI 工具推薦」→ ai-tools-recommend。名前が重複する場合は、末尾に -YYYYMMDD-HHMMSS を付けます。

バックアップ規則（全体に適用）：ファイル（ソース、アウトライン、プロンプト、画像）を上書きする前に、既存のファイルを <name>-backup-YYYYMMDD-HHMMSS.<ext> に名前変更します。これによりユーザーによる編集内容を保護できます。

ワークフロー

- [ ] Step 0: Load EXTEND.md ⛔ BLOCKING (interactive only)
- [ ] Step 1: Analyze content → analysis.md
- [ ] Step 2: Smart Confirm ⚠️ REQUIRED (Path A / B / C)
- [ ] Step 3: Generate images
- [ ] Step 4: Completion report

Step 0: EXTEND.md を読み込む ⛔ BLOCKING

次のパスを順番に確認し、最初に見つかったものを使用します：

パス	スコープ
.baoyu-skills/baoyu-image-cards/EXTEND.md	プロジェクト
${XDG_CONFIG_HOME:-$HOME/.config}/baoyu-skills/baoyu-image-cards/EXTEND.md	XDG
$HOME/.baoyu-skills/baoyu-image-cards/EXTEND.md	ユーザーのホーム

• 見つかった場合 → 読み込み、解析し、概要（スタイル／レイアウト／ウォーターマーク／言語）を表示して続行します。
• 見つからず、対話モードの場合 → 初回セットアップ（references/config/first-time-setup.md を参照）を実行し、ほかの処理を行う前に保存します。初回実行時の動作を予測可能にするため、設定が存在するまでは内容を分析したり、スタイルについて質問したりしてはいけません。
• 見つからず、--yes が指定されている場合 → セットアップを省略し、組み込みのデフォルトを使用します（ウォーターマークなし、スタイル／レイアウトは自動選択、言語はコンテンツから判定）。プロンプトを表示せず、EXTEND.md も作成しません。

EXTEND.md のキー：ウォーターマーク、優先するスタイル／レイアウト、カスタムスタイル定義、言語設定、優先する画像バックエンド、生成バッチサイズ。スキーマ：references/config/preferences-schema.md。

Step 1: コンテンツを分析する → analysis.md

1. ソースを保存します（source.md が存在する場合はバックアップ規則を適用します）。
2. references/workflows/analysis-framework.md に従って詳細な分析を実行します：コンテンツの種類、フックの可能性、対象読者、エンゲージメントのシグナル、ビジュアル活用機会のマップ、スワイプの流れ。
3. ソースの言語を検出し、推奨する画像枚数（2～10 枚）を選びます。
4. 上記の自動選択表を使って、戦略、スタイル、レイアウト、カラーパレットを自動で推奨します。
5. すべての内容を analysis.md に書き込みます。

ステップ 2：スマート確認 ⚠️ 必須

必須ゲート：確認ポリシーに従い、このステップは必須です。ユーザーがここで確認する（または現在のリクエストで --yes / 同等の表現を明示的に指定する）まで、ステップ 3 は開始できません。

目的：自動推奨プランを提示し、ユーザーに確認または調整してもらいます。--yes が指定されている場合は、このステップを完全にスキップし、分析と CLI の上書き設定を使ってパス A に進みます。

確認を求める前に、概要を表示します：

📋 内容分析
  主题：[topic] | 类型：[content_type]
  要点：[key points]
  受众：[audience]

🎨 推荐方案（自动匹配）
  策略：[A/B/C] [name]（[reason]）
  风格：[style] · 布局：[layout] · 配色：[palette or 默认] · 预设：[preset]
  图片：[N]张（封面+[N-2]内容+结尾）
  元素：[background] / [decorations] / [emphasis]

続いて、3 つのパスから 1 つを選ぶ質問を 1 つだけ行います。選択肢の文言は references/confirmation.md をそのまま使用してください。

パス A — クイック確認（自動推奨を採用）：推奨戦略とスタイルを使ってアウトラインを 1 つ生成し、outline.md に保存してからステップ 3 に進みます。

パス B — カスタマイズ：推奨内容をあらかじめ入力した状態で、5 つの質問（戦略／スタイル、レイアウト、パレット、枚数、任意のメモ）を行います。空欄の場合は推奨内容が維持されます。ユーザーの選択に基づいてアウトラインを 1 つ生成し、outline.md に保存してからステップ 3 に進みます。詳しくは references/confirmation.md を参照してください。

パス C — 詳細モード：確認を 2 回行います。

• ステップ 2a — コンテンツの理解：訴求ポイント（複数選択）、対象読者、スタイルの希望（authentic / professional / aesthetic / auto）、任意の補足情報を尋ねます。analysis.md を更新します。
• ステップ 2b — 3 種類のアウトライン案：outline-strategy-a.md、outline-strategy-b.md、outline-strategy-c.md を生成します。それぞれ異なる構成と異なる推奨スタイルにする必要があります。フロントマターに style_reason を含めてください。ページ数の目安：A は約 4～6、B は約 3～5、C は約 3～4。テンプレート：references/workflows/outline-template.md。フロントマターの例は references/confirmation.md を参照してください。
• ステップ 2c — 選択：3 つの質問（アウトライン A/B/C/Combined、スタイル、ビジュアル要素）を行います。選択または統合したアウトラインを outline.md に保存してからステップ 3 に進みます。

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

確認済みのアウトライン、スタイル、レイアウト、パレットを使います：

ビジュアルの一貫性 — image-1 アンカーチェーン：アンカーを設定しないと、呼び出しのたびにキャラクター／マスコット／色の描画がぶれることがあります。まず image 1（表紙）を --ref なしで生成し、その後のすべての画像には image 1 を --ref として渡してください。このスキルで一貫性を保つための最も重要なコツです。バックエンドがセッション ID にも対応している場合でも、省略しないでください。

生成の流れ：

1. すべての画像の完全なプロンプトを、ユーザーの希望言語で prompts/NN-{type}-{slug}.md に記述します（バックアップルールが適用されます）。その後、選択したプロンプトファイルがすべて存在することを確認します。
2. image 1 を最初に --ref なしで生成します。PNG ファイルにはバックアップルールが適用されます。これによってアンカーが確立されます。
3. image 1 を --ref <path-to-image-01.png> として使い、image 2 以降のタスクリストを作成します。
4. ## Batch Generation Policy に従って、image 2 以降をバッチに分けて実行します。まずバックエンドのネイティブバッチ機能を使い、次に実行環境の並列ツール呼び出しを使います。順次実行は最後の手段としてのみ使用します。
5. 画像が 1 枚生成されるたびに進捗を報告します。失敗した場合は、失敗した項目のみを、同じ保存済みプロンプトファイルを使って 1 回だけ再試行します。

透かし（EXTEND.md で有効な場合）：生成プロンプトに以下を追加します：

Include a subtle watermark "[content]" positioned at [position].
The watermark should be legible but not distracting.

references/config/watermark-guide.md を参照してください。

バックエンドの選択：冒頭の Image Generation Tools ルールに従い、利用可能なものを使用します。複数ある場合は、生成を開始する前に一度だけ確認してください。--yes が指定されている場合は、EXTEND.md の設定を使い、利用できない場合は最初に利用可能なバックエンドを使用します。バックエンドを呼び出す前に、プロンプトファイルが存在している必要があります。

セッション ID（バックエンドが --sessionId に対応している場合）：すべての画像に cards-{topic-slug}-{timestamp} を使用します。参照チェーンと組み合わせることで、一貫性を最大限に高められます。

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

Image Card Series Complete!

Topic: [topic]
Mode: [Quick / Custom / Detailed]
Strategy: [A/B/C/Combined]
Style: [name]
Palette: [name or "default"]
Layout: [name or "varies"]
Location: [directory]
Images: N total

✓ analysis.md
✓ outline.md
✓ outline-strategy-a/b/c.md (detailed mode only)

- 01-cover-[slug].png ✓ Cover (sparse)
- 02-content-[slug].png ✓ Content (balanced)
- ...
- NN-ending-[slug].png ✓ Ending (sparse)

コンテンツ分解の原則

位置	目的	典型的なレイアウト
表紙（image 1）	興味を引く＋ビジュアルインパクト	sparse
コンテンツ（中間）	画像ごとの主要な価値	balanced / dense / list / comparison / flow
最後（末尾）	CTA / まとめ	sparse または balanced

スタイルとレイアウトの互換性マトリクスについては、上記の Style × Layout Matrix を参照してください。

画像の変更

操作	方法
編集	まず prompts/NN-{type}-{slug}.md を更新し、その後、同じセッション ID で再生成します
追加	位置を指定し、プロンプトを作成して生成した後、後続のファイルを NN+1 に振り直し、アウトラインを更新します
削除	ファイルを削除し、後続のファイルを NN-1 に振り直して、アウトラインを更新します

再生成の前に、必ずプロンプトファイルを更新してください。これが信頼できる唯一の情報源であり、変更を再現可能にします。

テキスト修正ポリシー：

• カードのタイトル、本文、タグ、その他のレンダリングされたテキストに誤字や文字化けがある、読みづらい、または見栄えが弱い場合は、コードでビットマップを修正しないでください。
• テキスト修正のために再生成する場合は、新しいプロンプトファイルと新しい出力先パスを指定し、問題のある候補を比較用に残してください。
• 後処理は、テキストや全体の構図を変更しない、切り抜き、サイズ変更、圧縮、形式変換に限られます。

参照資料

ファイル	内容
references/confirmation.md	あらゆる確認手順で使用する AskUserQuestion の文面（原文）
references/style-presets.md	プリセットのショートカット定義一式
references/presets/<style>.md	スタイルごとの要素定義
references/palettes/<name>.md	パレットごとの色定義
references/elements/canvas.md	アスペクト比、安全領域、グリッドレイアウト
references/elements/image-effects.md	切り抜き、縁取り、フィルター
references/elements/typography.md	装飾文字、タグ、文字方向
references/elements/decorations.md	強調マーク、背景、落書き、フレーム
references/workflows/analysis-framework.md	コンテンツ分析フレームワーク
references/workflows/outline-template.md	レイアウトガイド付きアウトラインテンプレート
references/workflows/prompt-assembly.md	プロンプト作成ガイド
references/config/preferences-schema.md	EXTEND.md スキーマ
references/config/first-time-setup.md	初回セットアップのフロー
references/config/watermark-guide.md	透かしの設定

注意事項

• 生成に失敗した場合は、エラーを報告する前に一度だけ自動で再試行します。
• 公人を扱う場合は、様式化された漫画風の代替案を使用してください。
• Smart Confirm（Step 2）は必須です。詳細モードでは、2回目の確認（2a + 2c）が追加されます。

設定の変更

EXTEND.md は、Step 0 に記載されたパスのうち最初に見つかった場所にあります。変更方法は3つあります。

• 直接編集 — EXTEND.md を開いてフィールドを変更します。スキーマ全体は references/config/preferences-schema.md を参照してください。
• 対話形式で再設定 — EXTEND.md を削除するか、「reconfigure baoyu-image-cards preferences」または「重新配置」と依頼します。次回の実行時に初回セットアップが再び開始されます。
• よく使う1行の変更：
  • preferred_image_backend: auto — デフォルト。ランタイムネイティブのツールを優先し、利用可能なバックエンドが1つだけならそれにフォールバックします。ランタイムネイティブ以外のバックエンドが複数ある場合にのみ確認します。
  • preferred_image_backend: codex-imagegen — Codex 組み込みのバックエンドに固定します。
  • preferred_image_backend: baoyu-imagine — baoyu-imagine スキルに固定します。
  • preferred_image_backend: ask — 毎回バックエンドを確認します。
  • generation_batch_size: 4 — バックエンド／ランタイムがバッチ生成または並列生成に対応している場合に、同時にレンダリングする画像のデフォルト数です。
  • preferred_style: notion、preferred_layout: dense、preferred_palette: macaron、language: zh。
  • watermark.enabled: true + watermark.content: "@handle" — 透かしを追加します。