article-illustration-generator

記事イラスト生成ツール

このスキルは、Gemini Image API を使用してテキスト記事に関連するイラストを自動生成し、見栄えのよい HTML ファイルに変換します。

ワークフロー

1. API キーの確認：

   • まず、GOOGLE_API_KEY 環境変数が設定されているか確認します。
   • 設定されていない場合は、AskUserQuestion ツールを使用して、ユーザーが API キーを設定済みかどうか尋ねます。
   • ユーザーが設定していない場合は、Google API キーの入力を依頼します。
   • スクリプトの実行に使用するため、API キーを保存します。

2. 入力の分析：

   • ユーザーの記事テキストを読み込みます。
   • テキストを論理的なセクション（段落）に分割します。
   • イラストにする主要な場面を特定します（2～3 段落につき画像 1 枚を目安にします）。

3. 画像の生成：

   • 特定した各場面について、テキストの文脈に基づく説明的なプロンプトを作成します。
   • google.genai SDK を使用して画像を生成します。
   • モデル：gemini-2.5-flash-image（デフォルト、またはユーザー指定）。
   • 設定：記事用画像には aspect_ratio="16:9" または 4:3 を使用します。

4. HTML の構築：

   • assets/template.html にある HTML テンプレート（「故都的秋」スタイル）を使用します。
   • テキストと、ローカルに保存した生成画像を HTML 構造に挿入します。

リソース

このスキルには、references/ ディレクトリに次の参照ファイルが含まれています。

• references/template.html：セリフ体フォントとすっきりしたレイアウトを使用した HTML/CSS テンプレートです。出力ファイルのベースとして使用します。
• references/api_guide.md：高度な画像生成のニーズに使用できる Nano Banana Pro（Gemini 3 Pro Image）API の詳細なドキュメントです。
• references/script_template.py：API 呼び出しロジックを含む Python スクリプトのテンプレートです。

使用ガイド

呼び出されたとき、エージェントは次の手順を実行します。

1. API キーの設定を確認する：

   • Bash を使用して、GOOGLE_API_KEY 環境変数が設定されているか確認します。Linux/Mac では echo $GOOGLE_API_KEY、Windows では echo %GOOGLE_API_KEY% を実行します。
   • 空、または未設定の場合は、AskUserQuestion を使用して「Google API Key はすでに設定されていますか？」と尋ねます。
     • オプション 1：「はい。環境変数に設定済みです」— スクリプトを実行します。
     • オプション 2：「いいえ。API Key の入力が必要です」— API キーの入力を依頼し、コマンドライン引数としてスクリプトに渡します。
   • ユーザーが API キーを提供した場合は、この実行中に限り一時的に保存します。

2. ユーザーが提供した対象記事を読み込みます。

3. 画像の挿入位置を計画します。

4. 適切なパラメーターを指定して Python スクリプト（scripts/article_to_html.py）を実行します。

   • ユーザーから API キーが提供された場合：python scripts/article_to_html.py <article_file> <api_key>
   • 環境変数を使用する場合：python scripts/article_to_html.py <article_file>
   • オプションのパラメーター：--images N、--model MODEL、--ratio RATIO、--size SIZE

5. 結果を確認し、出力先をユーザーに伝えます。