菜单
Nano Banana（Google Gemini）圖像生成 SKILL。用於呼叫 Gemini 系列圖像模型（gemini-2.5-flash-image, gemini-3.1-flash-image-preview, gemini-3-pro-image-preview）生成概念圖、UCUF 參考探索圖、UI 資產草稿、icon、badge、卡面母稿。需要在 tools_mcp/nano-banana-mcp/.env 設定 GOOGLE_AI_API_KEY。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| doc_id | doc_agentskill_0020 |
| name | nano-banana-gen |
| description | Nano Banana（Google Gemini）圖像生成 SKILL。用於呼叫 Gemini 系列圖像模型（gemini-2.5-flash-image, gemini-3.1-flash-image-preview, gemini-3-pro-image-preview）生成概念圖、UCUF 參考探索圖、UI 資產草稿、icon、badge、卡面母稿。需要在 tools_mcp/nano-banana-mcp/.env 設定 GOOGLE_AI_API_KEY。 |
| argument-hint | 描述圖像目標、prompt 來源（直接或 --prompt-file）、輸出路徑、model 選擇（nano-banana / nano-banana-2），以及是否屬於 UCUF reference exploration 或 partial asset task。 |
用這個 skill 走專案內建的 Gemini 圖像包裝器，使用 Nano Banana 系列模型生圖。
Unity 對照：這類似於把「外部 AI 生成服務」包成一個固定的 Editor utility，讓不同 Agent 可以用同一個 wrapper 呼叫，不需要每次各自處理 API 串接。
| 社群暱稱 | alias flag | 正式 API modelId |
|---|---|---|
| Nano Banana | nano-banana | gemini-2.5-flash-image |
| Nano Banana 2 | nano-banana-2 | gemini-3.1-flash-image-preview |
| Nano Banana Pro | nano-banana-pro | gemini-3-pro-image-preview |
| 預設模型 | (預設) | gemini-2.5-flash-image |
artifacts/ 或其他工作目錄）。.meta。GOOGLE_AI_API_KEY 寫進 prompt、文件或腳本。tools_mcp/nano-banana-mcp/.env（複製 .env.example）：
GOOGLE_AI_API_KEY=AIza...
node .github/skills/nano-banana-gen/scripts/generate-banana.js --self-test --json
短 prompt 直接跑（預設模型）：
node .github/skills/nano-banana-gen/scripts/generate-banana.js --prompt "ancient Chinese ornamental frame border, pure decorative pattern, NO text NO calligraphy, transparent background, 512x512, PNG" --output artifacts/ui-source/general-detail-overview/reference/generated/frame-v1.png
長 prompt 建議走文字檔：
node .github/skills/nano-banana-gen/scripts/generate-banana.js --prompt-file artifacts/ui-source/general-detail-overview/reference/prompts/header_ornament_l.txt --output artifacts/ui-source/general-detail-overview/reference/generated/header_ornament_l.png --json
指定使用 Nano Banana（Flash 2.5）：
node .github/skills/nano-banana-gen/scripts/generate-banana.js --prompt-file artifacts/ui-source/general-detail-overview/reference/prompts/crest_face_final.txt --model nano-banana --output artifacts/ui-source/general-detail-overview/reference/generated/crest_face_final.png --json
只驗證 API Key，不生圖：
node .github/skills/nano-banana-gen/scripts/generate-banana.js --self-test --json
按順序執行，每張確認 "ok": true 後再跑下一張：
node .github/skills/nano-banana-gen/scripts/generate-banana.js --prompt-file artifacts/ui-source/general-detail-overview/reference/prompts/header_ornament_l.txt --model nano-banana --output artifacts/ui-source/general-detail-overview/reference/generated/header_ornament_l.png --json
node .github/skills/nano-banana-gen/scripts/generate-banana.js --prompt-file artifacts/ui-source/general-detail-overview/reference/prompts/header_ornament_r.txt --model nano-banana --output artifacts/ui-source/general-detail-overview/reference/generated/header_ornament_r.png --json
node .github/skills/nano-banana-gen/scripts/generate-banana.js --prompt-file artifacts/ui-source/general-detail-overview/reference/prompts/crest_face_final.txt --model nano-banana --output artifacts/ui-source/general-detail-overview/reference/generated/crest_face_final.png --json
node .github/skills/nano-banana-gen/scripts/generate-banana.js --prompt-file artifacts/ui-source/general-detail-overview/reference/prompts/crest_ring_final.txt --model nano-banana --output artifacts/ui-source/general-detail-overview/reference/generated/crest_ring_final.png --json
NO text, NO letters, NO calligraphy, NO characters。IMPORTANT: absolutely no text, no writing, no symbols, no characters of any language.v1 / v2a / v2b 個別 prompt file，不要塞進同一條。transparent background 但 Gemini 圖像模型不保證支援透明，建議另存後再去背。腳本回傳（--json 模式）：
{
"ok": true,
"model": "gemini-3.1-flash-image-preview",
"mimeType": "image/jpeg",
"savedTo": "c:\\Users\\User\\3KLife\\artifacts\\ui-qa\\...\\header_ornament_l.jpg",
"textContent": null
}
tools_mcp/nano-banana-mcp/node_modules/ （已安裝 @google/generative-ai@0.24.x + dotenv）tools_mcp/nano-banana-mcp/.env 讀取，wrapper 不處理金鑰savedTo 會依模型實際回傳的 mimeType 自動對齊副檔名；Gemini 3.1 / Pro 常見為 .jpg--model nano-banana-2 或 --model nano-banana-pro生成圖片後，若需要 view_image 檢視，必須先跑 node tools_node/prepare-view-image-progressive.js --input <path> --level thumb 再送入 view_image（見 image-view-guard）。
ATM Captain 派工治理。觸發詞 派工 / 派工單 / dispatch / 開卡 / 派任務 / 派代理 / Phase 0 / Phase 1 / AAO / task card / condition review / 收口。負責 AI-Atomic-Framework (AAF) + 3KLife 雙 repo 治理：強制 Context Map 4 層、雙代理拆分（防外卡 mirror commit）、AAF 嚴格 2 commit、3KLife target_repo 嚴格 1 commit、7-8 段回報、禁止清單前置強化、Captain condition review。承載 0064 → 0093+ 累積的紀律教訓。
通用任務開單器 SKILL — 統一建立或回寫 Markdown task card、docs/tasks/tasks-*.json 分片、UI quality shard，並強制遵守 docs/agent-briefs/Readme.md (doc_ai_0023) 與 docs/遊戲規格文件/系統規格書/名詞定義文件.md (doc_spec_0008) 的硬規則。USE FOR: 開任務卡、開單、task card、task shard、tasks-ui.json、tasks-prog.json、tasks-dc.json、tasks-data.json、agent-briefs/tasks、docs/tasks/*_task.md、UI pipeline 開卡。DO NOT USE FOR: 純 runtime 除錯、單純修改既有功能碼但不需要新卡、只做極小 typo 修補。
Plan ATM framework refactors by preserving atom/map semantics before splitting large governance modules.
Route natural-language cleanup, refactor, migration, and candidate ranking goals through ATM before local analysis.
Recommend the next official ATM guidance action from current state.
Resolve the current user prompt into an atm.taskIntent.v1 proposal before next-action routing.