---
name: nanobanana2-freestyle
description: Nano Banana 2 (Gemini 3.1 Flash Image Preview) を用いて、エージェントがプロンプト構築から画像生成（Python/API）まで一貫実行するスキル
---

# Nano Banana 2 フリースタイル生成スキル (nanobanana2-freestyle)

## 📌 コンセプト
本スキルは、ユーザーと対話して生成イメージ（用途、アスペクト比など）をヒアリングし、Nano Banana 2（`gemini-3.1-flash-image-preview`）のベストプラクティスに基づいた**高精度な英語プロンプト**と**確認用日本語訳**を提示します。ユーザー承認後、AI（Antigravity）自身がローカルの専用仮想環境でPythonスクリプトを実行し、直接画像を生成・保存する「自己完結型」の画像生成エンジンです。

---

## 🛠️ 環境前提
- **実行モデル**: `gemini-3.1-flash-image-preview`（完全限定）
- **動作フォルダ**: スキルがインストールされたパス（例: `{SKILLS_ROOT}/nanobanana2-freestyle/`）
- **出力フォルダ**: デフォルトはスキル直下 `outputs/NanoBanana_Generations/`。`--output_dir` 引数で任意パスに変更可能。
- **認証**: システム環境変数の `GEMINI_API_KEY` を使用。

## 🎯 アンチグラビティ（AI）の実行手順

### ステップ1: ヒアリング（Interview）
以下の項目をユーザーに質問し、要件を固める。
1. **生成したい画像の内容:** (例: どんなシーンか、スタイル、オブジェクト等)
2. **目的・テイスト:** (例: フォトリアル、イラスト、ステッカー、商品モックアップ等)
3. **アスペクト比:** (例: 16:9, 1:1, 9:16)
4. **参照画像の有無:** (※参照画像がある場合はフルパスを収集する)

### ステップ2: プロンプトと構成案の提示・承認
ヒアリング内容と「Nano Banana 2 高度なプロンプト戦略（構図・照明・スタイル等の詳細描写）」に基づき、以下を画面に提示し、ユーザーから実行承認を得る。

```markdown
【生成プランの提示】
- 作成方針: [戦略・スタイルなど]
- アスペクト比: [例: 16:9]
- 保存先: [作成予定の一意なフォルダ名]

【生成プロンプト（英語）】
A photorealistic shot of ...

【確認用ダミーテキスト（日本語訳）】
...のフォトリアルなショット
```
> [!IMPORTANT]
> 「この内容で画像生成プロセスを実行してよろしいでしょうか？」と必ず確認を取ること。

### ステップ3: スクリプトの実行（API生成）
ユーザーの承認が下りたら、以下のコマンドで環境構築・画像生成スクリプトを実行する。
※初回などで `venv` が無い場合は、`python -m venv venv` などを提案・代替すること。

```bash
cd "{SKILLS_ROOT}/nanobanana2-freestyle"
python generate.py --prompt "構築した英語プロンプト" --aspect_ratio "16:9" --name "ユニークな出力名"
# 出力先を明示する場合: --output_dir "{任意のフォルダパス}"
```
*(※必要に応じて、参照画像を `--ref_img_1 "パス"` のように渡すようスクリプトを拡張してもよい)*

### ステップ4: 結果報告
- 実行成功時：保存先フォルダのフルパスと、画像ファイルのパスをユーザーに提示し、「続いて作成しますか？」等、次のアクションを伺う。
- エラー時：Okihiro Forgeの `ERROR_HANDLING_RULES` に従い、エラー内容を報告して修正を行う。

---

## 🚫 注意事項（SECURITY & RULES）
- APIキー等のパスワード・認証情報は、決してAIの出力・画面に表示しない。
- 実行スクリプトの引数として渡すプロンプトに、意図せぬシェルインジェクション文字が含まれないようにエスケープに留意する（Pythonの `subprocess` や `run_command` ツールの仕様による）。
