baoyu-xhs-images について
baoyu-xhs-imagesは、複雑な内容を複数枚の画像カードにまとめるスキルです。ビジュアルコンテンツの制作向けに、スタイル、レイアウト、配色を個別に選べます。
主な機能
- 01内容を画像カードシリーズに分解
- 0212種類のビジュアルスタイル
- 038種類の情報レイアウト
- 04配色オプションとプリセット
- 05参考画像を使ったバッチ生成
活用シーン
- 01複雑なテーマを知識カードに整理
- 02リスト、比較、手順カードの作成
- 03SNS共有用の画像シリーズ制作
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ jimliu/ baoyu-skills --skill baoyu-xhs-imagesインストール後、Claude Code で/baoyu-xhs-imagesを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/codex-imagegen.mdconfirmation.mdstyle-presets.mdreferences/config/first-time-setup.mdpreferences-schema.mdwatermark-guide.mdreferences/elements/canvas.mddecorations.mdimage-effects.mdtypography.mdreferences/palettes/macaron.mdneon.mdwarm.mdreferences/presets/bold.mdchalkboard.mdcute.mdfresh.mdminimal.mdnotion.mdpop.mdretro.mdscreen-print.mdsketch-notes.mdstudy-notes.mdwarm.mdreferences/workflows/analysis-framework.mdoutline-template.mdprompt-assembly.md詳細
画像カードシリーズジェネレーター
複雑なコンテンツを、目を引く複数のスタイルから選べる画像カードシリーズに分解します。
ユーザー入力ツール
このスキルがユーザーに入力を求める場合は、次の優先順位に従ってツールを選択してください。
- 組み込みのユーザー入力ツールを優先してください。現在のエージェントランタイムが公開している
AskUserQuestion、request_user_input、clarify、ask_user、または同等のツールなどです。 - フォールバック:そのようなツールがない場合は、番号付きのプレーンテキストメッセージを出力し、各質問について選択した番号または回答をユーザーに返信してもらってください。
- まとめて質問:1 回の呼び出しで複数の質問に対応できるツールであれば、該当する質問をすべてまとめてください。1 回に 1 つの質問しかできない場合は、優先順位に従って 1 つずつ質問してください。
以下の AskUserQuestion に関する具体的な記述は例です。他のランタイムでは、ローカルの同等ツールに置き換えてください。
画像生成ツール
このスキルで画像をレンダリングする必要がある場合は、次の順序でバックエンドを選択してください。
- 現在のリクエストによる指定 — ユーザーが現在のメッセージで特定のバックエンドを指定している場合は、それを使用してください。
- 保存済みの設定 —
EXTEND.mdでpreferred_image_backendに現在利用可能なバックエンドが設定されている場合は、それを使用してください。 - 自動選択(設定が
auto、未設定、または固定されたバックエンドが利用できない場合):- Codex(
imagegen) — まず、利用可能なスキル/ツールの一覧を確認してください。imagegenという名前のスキルが一覧にある場合は、Codex 内で実行されています。必ずSkillツールをskill: "imagegen"で呼び出し、保存済みプロンプトファイルの内容(出力パスとアスペクト比を含め、Codeximagegen独自の引数に従う)を渡してください。このランタイムでは Codeximagegenが公式のラスター画像バックエンドであり、ユーザーが別のpreferred_image_backendを明示的に固定していない限り、ネイティブでないスキル(例:baoyu-image-gen)より優先されます。 codex exec経由の Codex(codex-imagegen) — 現在のランタイムにネイティブのimagegenスキルがなく、codexCLI がPATH上にあり、アクティブなcodex loginがある場合は、baoyu-image-gen --provider codex-cli経由で実行してください(推奨)。baoyu-image-genが利用できない場合は、同梱のラッパーを直接呼び出してください。詳細、パラメーター、ランタイムの検出手順は references/codex-imagegen.md にあります。この分岐を選択した場合に限り、そのファイルを読み込んでください。- Cursor(
GenerateImage) — ランタイムにネイティブのGenerateImageツールがある場合は、Cursor 内で実行されています。Codeximagegenと同様に、ネイティブでないスキルより優先されます。次の 2 つの注意事項は必ず守ってください。(a)アスペクト比のパラメーターがありません。descriptionとして渡すプロンプトテキストに、目標のアスペクト比または寸法を明記してください。(b)出力ディレクトリを指定できません。ツールが管理する場所に保存されるため、生成後にファイルをスキルで想定されている出力パス(例:outputs/.../NN-xxx.png)へコピーまたは移動してください。参照画像はreference_image_pathsに指定してください。 - その他のランタイムネイティブツール — ランタイムに別のネイティブ画像ツール(例:Hermes
image_generate)がある場合は、同じ方法で使用してください。 - それ以外の場合、ネイティブでないバックエンドが 1 つだけインストールされている場合(例:
baoyu-image-gen)は、それを使用してください。 - それ以外の場合(ランタイムネイティブツールがなく、ネイティブでないバックエンドが複数ある場合)は、ユーザーに一度だけ質問してください。他の初回質問がある場合は、まとめて質問してください。
- Codex(
- 利用可能なバックエンドがない場合は、その旨をユーザーに伝え、どのように進めるか尋ねてください。
⛔ ラスター画像の生成を 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)は例です。同じルールに従い、ローカル環境の相当するツールに置き換えてください。
バッチ生成ポリシー
現在の生成グループに含まれるすべてのプロンプトファイルを保存し、確認した後は、デフォルトで画像をバッチ生成してください。
優先順位:
- 選択したバックエンドにネイティブのバッチ/マルチタスクインターフェイスがある場合は、それを使用してください。各タスクには、それぞれのプロンプトファイル、出力先、アスペクト比、セッション ID、直接参照する画像を設定してください。
- ネイティブのバッチインターフェイスがなく、ランタイムが並列ツール呼び出しに対応している場合は、
generation_batch_size枚ずつ(最大)実行してください。デフォルトは4です。現在のメッセージで--batch-size 4や「并行 4 张一起生成」など、ユーザーが明示的に指定した場合は、EXTEND.md の設定より優先されます。 - ネイティブのバッチ機能も並列ツール呼び出しも利用できない場合は、順番に生成してください。
ルール:
- 画像 1 のアンカーチェーンを守ってください。まず画像 1 を生成し、その後、画像 1 を参照画像として画像 2 以降をバッチ生成してください。
- そのバッチで選択したプロンプトファイルがすべてディスク上に存在するまでは、バッチを開始しないでください。
- 失敗した項目のみ一度再試行し、成功した項目は再生成しないでください。
- 画像のレンダリングを並列化するためだけにサブエージェントを使ってはいけません。サブエージェントは、別個のプロンプトの反復やクリエイティブな検討に限って使用してください。
確認ポリシー
デフォルトの動作:生成前に確認する。
- 明示的なスキルの呼び出し、ファイルパス、一致したシグナル/プリセット、
EXTEND.mdのデフォルト設定は、あくまで推奨内容の入力として扱ってください。いずれも確認を省略する許可にはなりません。 - ユーザーがステップ 2 を完了するまで、ステップ 3 を開始しないでください。
- 現在のリクエストに
--yes、「直接生成」「確認不要」「確認をスキップ」「デフォルトで画像を生成」など、同等の表現が明示されている場合に限り、確認を省略できます。 - 明示的に確認が省略された場合は、生成前の次のユーザー向け進捗報告で、想定した方針/スタイル/レイアウト/パレット/枚数/バックエンドを伝えてください。
言語
質問、進捗報告、エラー、完了サマリーは、ユーザーの言語で応答してください。技術的なトークン(スタイル名、ファイルパス、コード)は英語のままにしてください。
オプション
| オプション | 説明 |
|---|---|
--style <name> | ビジュアルスタイル(以下の「スタイル」を参照) |
--layout <name> | 情報レイアウト(以下の「レイアウト」を参照) |
--palette <name> | 色の上書き:macaron / warm / neon |
--preset <name> | スタイル+レイアウト+任意のパレットをまとめて指定する省略形(以下の「プリセット」を参照。プリセットごとのプロンプト断片は references/style-presets.md を参照) |
--ref <files...> | シリーズのアンカーとなる画像 1 に適用する参照画像 |
--batch-size <n> | この実行でのみ使用する一時的な生成バッチサイズ。デフォルトは、EXTEND.md に generation_batch_size があればその値、なければ 4 です。1~8 の範囲に制限してください。 |
--yes | 非対話モード:すべての確認を省略し、EXTEND.md または組み込みのデフォルトを使用して、推奨プラン(パス 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 | 4象限/円形のセクション |
レイアウトの仕様: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 を使用します。
| ソース内のシグナル | スタイル | レイアウト | 推奨プリセット |
|---|---|---|---|
| 美容、ファッション、かわいい、女の子、ピンク | cute | sparse/balanced | cute-share、girly |
| 健康、自然、フレッシュ、オーガニック | fresh | balanced/flow | product-review、nature-flow |
| 生活、物語、感情、温かみ | warm | balanced | cozy-story |
| 警告、重要、必須、重大 | bold | list/comparison | warning、versus |
| 専門的、ビジネス、エレガント | minimal | sparse/balanced | clean-quote、pro-summary |
| 古典的、ヴィンテージ、伝統的 | retro | balanced | throwback、retro-ranking |
| 楽しい、ワクワクする、すごい、素晴らしい | pop | sparse/list | hype、pop-facts |
| 知識、概念、生産性、SaaS | notion | dense/list | knowledge-card、checklist |
| 教育、チュートリアル、学習、教室 | chalkboard | balanced/dense | tutorial、classroom |
| ノート、手書き、学習ガイド、リアル | study-notes | dense/list/mindmap | study-guide |
| 映画、ポスター、意見、エディトリアル、映画的 | screen-print | sparse/comparison | poster、editorial、cinematic |
| 手描き、インフォグラフィック、ワークフロー、手描き、図解 | sketch-notes | flow/balanced/dense | hand-drawn-edu、sketch-card、sketch-summary |
スタイル × レイアウトのマトリクス
互換性スコア(✓✓ 強く推奨、✓ 適合、✗ 非推奨)。ユーザーがデフォルト以外の組み合わせを選び、相性の悪さを伝えたい場合に使用します。
| 余白多め | バランス | 高密度 | リスト | 比較 | フロー | マインドマップ | 象限 | |
|---|---|---|---|---|---|---|---|---|
| かわいい | ✓✓ | ✓✓ | ✓ | ✓✓ | ✓ | ✓ | ✓ | ✓ |
| フレッシュ | ✓✓ | ✓✓ | ✓ | ✓ | ✓ | ✓✓ | ✓ | ✓ |
| 温かみ | ✓✓ | ✓✓ | ✓ | ✓ | ✓✓ | ✓ | ✓ | ✓ |
| 大胆 | ✓✓ | ✓ | ✓ | ✓✓ | ✓✓ | ✓ | ✓ | ✓✓ |
| ミニマル | ✓✓ | ✓✓ | ✓✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| レトロ | ✓✓ | ✓✓ | ✓ | ✓✓ | ✓ | ✓ | ✓ | ✓ |
| ポップ | ✓✓ | ✓✓ | ✓ | ✓✓ | ✓✓ | ✓ | ✓ | ✓ |
| notion | ✓✓ | ✓✓ | ✓✓ | ✓✓ | ✓✓ | ✓✓ | ✓✓ | ✓✓ |
| 黒板 | ✓✓ | ✓✓ | ✓✓ | ✓✓ | ✓ | ✓✓ | ✓✓ | ✓ |
| 学習ノート | ✗ | ✓ | ✓✓ | ✓✓ | ✓ | ✓ | ✓✓ | ✓ |
| シルクスクリーン | ✓✓ | ✓✓ | ✗ | ✓ | ✓✓ | ✓ | ✗ | ✓✓ |
| スケッチノート | ✓ | ✓✓ | ✓✓ | ✓✓ | ✓ | ✓✓ | ✓✓ | ✓ |
アウトラインの構成方針
それぞれ異なる構造のアウトラインを生成する、3 つのアプローチです。ワークフローでは 1 つを推奨します。Path C では 3 つすべてを生成し、ユーザーが選べます。
| 方針 | コンセプト | 最適な用途 | 構成 |
|---|---|---|---|
| A — ストーリー重視 | 個人的な体験を軸にし、まず感情に訴えます | レビュー、個人的な共有、変化 | 導入 → 課題 → 発見 → 体験 → 結論 |
| B — 情報重視 | 価値を最初に示し、効率よく情報を伝えます | チュートリアル、比較、チェックリスト | 結論の要点 → 情報カード → メリット/デメリット → 推奨 |
| C — ビジュアル重視 | ビジュアルのインパクトを主軸に、テキストを最小限にします | 美的魅力の高い製品、ライフスタイル、ムードコンテンツ | メイン画像 → 詳細ショット → ライフスタイルシーン → CTA |
参照画像
ユーザーが提供する参照画像は、内部の「image-1 をアンカーにする」チェーン(Step 3)とは別扱いです。これに加えて適用します。
受け取り:--ref <files...> または会話に貼り付けられたパスから取得します。
- ファイルパス →
refs/NN-ref-{slug}.{ext}にコピーします - パスなしで貼り付けられた場合 → パスを尋ねるか、スタイルの特徴を抽出してテキストで代替します
使用方法(参照画像ごと):
| 使用方法 | 効果 |
|---|---|
direct | ファイルをバックエンドに渡します(通常は image 1 のみに適用し、アンカーがチェーン全体に引き継がれるようにします) |
style | スタイルの特徴を抽出し、すべてのカードのプロンプト本文に追加します |
palette | 16 進カラーコードを抽出し、すべてのカードのプロンプト本文に追加します |
影響を受ける各カードのプロンプトのフロントマターに参照画像を記録します。
references:
- ref_id: 01
filename: 01-ref-brand.png
usage: direct
生成時には、ファイルが存在することを確認します。usage: direct の image 1 と参照画像を受け付けるバックエンドの場合、バックエンドの参照パラメーターを使って渡します(チェーンのアンカーになります)。Step 3 に従い、image 2 以降では引き続き 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 語の kebab-case にします。「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
ステップ 0:EXTEND.md を読み込む ⛔ BLOCKING
以下のパスを順番に確認します。最初に見つかったものを使用します。
| パス | スコープ |
|---|---|
.baoyu-skills/baoyu-xhs-images/EXTEND.md | プロジェクト |
${XDG_CONFIG_HOME:-$HOME/.config}/baoyu-skills/baoyu-xhs-images/EXTEND.md | XDG |
$HOME/.baoyu-skills/baoyu-xhs-images/EXTEND.md | ユーザーホーム |
- 見つかった場合 → 読み込み、解析し、概要(スタイル/レイアウト/透かし/言語)を表示して続行します。
- 見つからず、対話モードの場合 → 初回セットアップを実行します(
references/config/first-time-setup.mdを参照)。ほかの処理を行う前に保存してください。設定が存在するまでは、コンテンツを分析したり、スタイルについて質問したりしないでください。これにより、初回実行時の動作を予測しやすくできます。 - 見つからず、
--yesの場合 → セットアップをスキップし、組み込みのデフォルトを使用します(透かしなし、スタイル/レイアウトは自動選択、言語はコンテンツから判定)。プロンプトを表示せず、EXTEND.md も作成しません。
EXTEND.md のキー:透かし、推奨スタイル/レイアウト、カスタムスタイル定義、言語設定、推奨画像バックエンド、生成バッチサイズ。スキーマ:references/config/preferences-schema.md。
ステップ 1:コンテンツを分析 → analysis.md
- ソースを保存します(
source.mdが存在する場合はバックアップルールが適用されます)。 references/workflows/analysis-framework.mdに記載された詳細分析を実行します:コンテンツの種類、フックの可能性、対象ユーザー、エンゲージメントのシグナル、視覚的な機会マップ、スワイプの流れ。- ソースの言語を検出し、推奨画像数(2~10)を選択します。
- 上記の自動選択テーブルを使って、戦略+スタイル+レイアウト+パレットを自動で推奨します。
- すべての内容を
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]
その後、1 つの質問をします。選択肢は 3 つです。文言は references/confirmation.md のとおりにしてください。
パス A — クイック確認(自動推奨を採用):推奨された戦略+スタイルを使ってアウトラインを 1 つ生成し、outline.md に保存してステップ 3 に進みます。
パス B — カスタマイズ:推奨内容をあらかじめ入力した状態で、5 つの項目(戦略/スタイル、レイアウト、パレット、枚数、任意のメモ)について質問します。空欄の場合は推奨内容を維持します。ユーザーの選択に基づいてアウトラインを 1 つ生成し、outline.md に保存してステップ 3 に進みます。references/confirmation.md を参照してください。
パス C — 詳細モード:確認を 2 回に分けて行います。
- ステップ 2a — コンテンツの把握:訴求ポイント(複数選択可)、対象ユーザー、スタイルの希望(本格的/プロフェッショナル/美的/自動)、任意のコンテキストを質問します。
analysis.mdを更新します。 - ステップ 2b — 3 つのアウトライン案:
outline-strategy-a.md、outline-strategy-b.md、outline-strategy-c.mdを生成します。それぞれ構成と推奨スタイルを変える必要があります。frontmatter にstyle_reasonを含めてください。ページ数の目安:A は約 4~6 ページ、B は約 3~5 ページ、C は約 3~4 ページです。テンプレート:references/workflows/outline-template.md。frontmatter の例はreferences/confirmation.mdにあります。 - ステップ 2c — 選択:3 つの項目(アウトライン A/B/C/組み合わせ、スタイル、視覚要素)について質問します。選択または統合したアウトラインを
outline.mdに保存してステップ 3 に進みます。
ステップ 3:画像を生成する
アウトライン+スタイル+レイアウト+配色が確定したら:
ビジュアルの一貫性 — image-1 アンカーチェーン:呼び出しごとにキャラクター/マスコット/色の描画がぶれないよう、アンカーを設定します。まず --ref なしで画像 1(表紙)を生成し、その後のすべての画像で画像 1 を --ref として渡します。このスキルで一貫性を保つための最も重要なコツです。バックエンドがセッション ID にも対応している場合でも、省略しないでください。
生成の流れ:
- すべての画像の完全なプロンプトを、ユーザーの希望する言語で
prompts/NN-{type}-{slug}.mdに書き込み(バックアップルールが適用されます)、選択したプロンプトファイルがすべて存在することを確認します。 - まず 画像 1 を
--refなしで生成します。PNG ファイルにはバックアップルールが適用されます。これがアンカーになります。 - 画像 1 を
--ref <path-to-image-01.png>として使用し、画像 2 以降のタスクリストを作成します。 ## Batch Generation Policyに従って、画像 2 以降をバッチでディスパッチします。バックエンドのネイティブなバッチ処理を最初に使い、次にランタイムの並列ツール呼び出しを使います。逐次処理は最後の手段としてのみ使用します。- 画像の生成が完了するたびに進捗を報告します。失敗した場合は、保存済みの同じプロンプトファイルを使って、失敗した項目のみを 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 の設定を使用し、利用可能な最初のバックエンドにフォールバックします。バックエンドを呼び出す前に、プロンプトファイルが必ず存在していなければなりません。
codex-imagegen の呼び出し:ルールによって codex-imagegen が選択された場合は、呼び出しの仕様(推奨される baoyu-image-gen --provider codex-cli の経路、ランタイムラッパーの検出、パラメーターに関する注意、標準出力のスキーマ、バッチ処理の仕様 — 呼び出しごとに n=1 のため、カードのバッチではカードごとにラッパー呼び出しを 1 回ディスパッチする必要があります。ラッパーは --sessionId を受け付けないため、チェーンの一貫性は上記のステップ 3 に従い --ref で保つ必要があります)について、references/codex-imagegen.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)
コンテンツの構成原則
| 位置 | 目的 | 典型的なレイアウト |
|---|---|---|
| 表紙(画像 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 | 透かしの設定 |
注意事項
- 生成に失敗した場合は、エラーを報告する前に一度だけ自動で再試行します。
- 公人を扱う場合は、様式化した代替のカートゥーンを使用してください。
- スマート確認(ステップ 2)は必須です。詳細モードでは、2回目の確認(2a + 2c)が追加されます。
設定の変更
EXTEND.md は、ステップ 0 に記載されたパスのうち最初に見つかった場所にあります。変更方法は3つあります。
- 直接編集 — EXTEND.md を開き、フィールドを変更します。スキーマ全体については
references/config/preferences-schema.mdを参照してください。 - 対話形式で再設定 — EXTEND.md を削除するか、「reconfigure baoyu-xhs-images 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— バックエンド/実行環境がバッチ生成または並列生成に対応している場合に、同時にレンダリングする画像のデフォルト数です。preferred_style: notion、preferred_layout: dense、preferred_palette: macaron、language: zh。watermark.enabled: true+watermark.content: "@handle"— 透かしを追加します。