コンテンツ制作 · prime-skills/runcomfy-agent-skills

nano-banana-edit

RunComfy 上で Google Nano Banana 2(image-to-image 編集エンドポイント)を使用して画像を編集します。Nano Banana Edit の強み(被写体の同一性保持、背景の差し替え、空間表現による編集箇所の特定、最大20件のマルチ画像バッチ編集)、スキーマ、および GPT Image 2 edit / Flux Kontext / Nano Banana 2 t2i へルーティングすべきケースについて解説します。ローカルの RunComfy CLI を通じて `runcomfy run google/nano-banana-2/edit` を呼び出します。「nano banana edit」、「edit with nano banana」、「image edit nano banana」、または本モデルでの編集を明示的に要求するプロンプトによってトリガーされます。

L4 高権限 · 段階的認可と監査V1 コミット固定コマンド実行ネットワーク通信ファイル書き込みDual-pass Audit
Author prime-skillsGitHub prime-skills/runcomfy-agent-skills ↗Stars 43License MIT(仓库根 LICENSE:Copyright (c) 2026 RunComfy / agentspace-so;GitHub API spdx=MIT)Commit fca19ae084
管理レベルは Skill の能力と推奨統制措置を示すものであり、品質や安全性の認証、利用可否の判定ではありません。使用の可否はユーザーおよび管理者が決定します。Agent 環境によって制約が異なるため、自動保護を仮定しないでください。第三者製 Skill の著作権は原著作者に帰属し、利用リスクは利用者が負います。

1仕組みと動作原理

単一エンドポイント専用ドキュメント(i2i 編集): `google/nano-banana-2/edit` を中心に構成され、主要パラメータは `image_urls` 配列(クロール可能な公開 URL 1〜20枚、先頭画像がメインアンカー)、`number_of_images`(出力1〜4枚)、`seed`、`aspect_ratio`、`resolution`、`output_format`、`safety_tolerance`、`limit_generations`、`enable_web_search` です。

nano-banana-edit/SKILL.md
| `image_urls` | array | yes | — | **1–20** publicly-fetchable HTTPS URLs. |
兄弟モデルである `nano-banana-2` との唯一の構造的相違は入力インターフェースにあります。t2i がプロンプトを受け取るのに対し、本エンドポイントは「プロンプト + 最大20枚の URL」を受け取るため、バッチ単位の一貫した編集(SKU ギャラリー / A/B テスト)が本スキルの真骨頂となっています。

第一プロンプト原則 = 保持優先(preservation-first): 変更内容を記述する前に、まず「Keep [identity/pose/clothing/brand/framing] unchanged」を前置します。ドキュメントにはそのメカニズム上の理由(モデルは前置された保持対象のみを厳密に考慮する)も明記されています。

nano-banana-edit/SKILL.md
**Preservation first, change last.** Always lead with `"Keep [identity / pose / clothing / brand / framing] unchanged."` Then state the change in one clean sentence. Models honor what's stated up front; tail-end preservations get ignored.
この原則はマニュアルであると同時にモデルの挙動特性の観察結果(文末の保持指示は無視されやすい)でもあり、「モデルがプロンプトをどう解釈するか」という知見を記述順序の規律へと昇華させたものです。`image-edit` の Route 1 と共通の表現形式を採用しており、両者が同一の設計思想に基づいていることを示しています。

空間表現による局所編集の実現: 「background only」、「the left object」、「upper-right corner」などの具体的な空間指定をモデルは正確に認識します。一方、「make it more X」といった曖昧な指示は意図しないブレの原因となります。

nano-banana-edit/SKILL.md
**Localize with spatial language.** "background only", "the left object", "the upper-right corner", "above the headline" — concrete spatial scopes are honored. "make it more X" is vague and drifts.
3つの実行例(背景の変更、一括ウォーターマークの置換、左側のオブジェクトの削除)は、いずれも空間限定の構文で締めくくられており、規律の実践例となっています。

バッチ一貫性の規律: シリーズ編集では `aspect_ratio` + `resolution` を固定し、同一のプロンプト構文を使用することで、バッチ出力を単なるリミックスではなく「兄弟(sibling)」アセットとして揃えます。また、複雑な編集は複合指示として一度に行わず、小さなステップに分解して反復します。

nano-banana-edit/SKILL.md
**Batch consistency** — when editing a series, lock `aspect_ratio` and `resolution`. Use the same prompt grammar across the batch so each output reads as a sibling, not a remix.
「Iterate small」セクション(`pass 1 changes background only, pass 2 swaps the subject's outfit`)およびアンチパターン一覧(複合指示によるブレの蓄積、受動態、保持対象の欠落、アスペクト比の不一致)と組み合わされ、包括的な運用ガイドラインを形成しています。

境界とルーティング: 多言語の画像内テキスト編集は明確に GPT Image 2 edit に委譲し、単一参照の高精度な局所編集は Flux Kontext に、ゼロからの生成は兄弟モデルの nano-banana-2 t2i に委譲します。本スキルは万能性を標榜しません。

nano-banana-edit/SKILL.md
| Edit multilingual text inside the image (signs, labels) | GPT Image 2 edit |
Limitations セクションでさらに `For multilingual in-image text edits, GPT Image 2 edit wins.` と補足されており、リポジトリ内の `image-edit`(GPT Image 2 ルートを含む)やブランド化された `gpt-image-edit` スキルと適切な役割分担が確立されています。

runcomfy CLI + クラウド推論への実行委任: `runcomfy run google/nano-banana-2/edit --input '{...}' --output-dir` を実行し、CLI が完全な API URL へ POST リクエストを送信し、ポーリングして結果をダウンロードします。

nano-banana-edit/SKILL.md
The skill invokes `runcomfy run google/nano-banana-2/edit` with a JSON body matching the schema. The CLI POSTs to `https://model-api.runcomfy.net/v1/models/google/nano-banana-2/edit`, polls the request, fetches the result, and downloads any `.runcomfy.net`/`.runcomfy.com` URL into `--output-dir`.
編集タスクの入力は外部の画像 URL です。画像データは RunComfy サーバー側が取得し、ローカル CLI からは JSON のみが送信されます。

2コア機能

011〜20枚の入力画像に対するバッチ一貫編集(SKU ギャラリー、A/B テスト、キャラクター設定バリエーション)
02同一性を保持した背景・衣装の差し替え(preservation-first 構文)
03空間表現による局所的な追加・削除・変更(left object / corner / above the headline など)
04構図の固定(framing lock)+ 同一構文による兄弟シリーズ出力(EC ブランドアセットの再構成)
05seed 固定 + number_of_images による広告クリエイティブの A/B バリエーション生成
06画像内テキストの局所的な置換(構図を維持したままテキストや配色の変更)

3外部依存関係

KindDependency / Endpoint
cliruncomfy(@runcomfy/cli 官方 CLI)
package@runcomfy/cli(npm 全局安装)
apiGoogle Nano Banana 2 图生图编辑端点(RunComfy Model API 托管)
network生成结果下载白名单
network用户提供的 1–20 张输入图 URL——由 RunComfy 模型服务器抓取
networkRunComfy 模型页 / 文档站(引用链接)

4推奨統制措置と判定根拠

安全運用のための推奨統制措置
Agent 向け
段階的・都度認可、サンドボックス推奨
管理者向け
承認フロー、ロールバック可能、全履歴監査
判定根拠(ファイルパスと抜粋)
  • 网络端点: 外部ネットワークアクセスの宣言: model-api.runcomfy.net/v1/models/google/nano-banana-2/edit — 編集リクエストの送信(runcomfy CLI 経由)
  • 本地工作目录: ファイル I/O および成果物の出力: CLI が生成結果を --output-dir で指定されたローカルディレクトリにダウンロード(パスは呼び出し側が決定)
  • SKILL.md: ホストの CLI インタプリタまたは外部実行環境の呼び出しを宣言
監査ノート: 統一判定基準に基づく評価: 実行時にサードパーティ製 npm パッケージ/CLI である `@runcomfy/cli` を呼び出し、実行のたびにユーザーの RunComfy 認証情報(`~/.config/runcomfy/token.json` または `RUNCOMFY_TOKEN` 環境変数)を読み取ります。これは「サードパーティの npm/CLI を呼び出し、クォータや機密情報を読み取る可能性がある -> オレンジ(要確認)」に該当します。実行環境(CLI、Model API、トークンの読み取り)はすべてリポジトリ外部にあり、ドキュメントの記載(0600 権限、2 GiB 上限、シェル展開の不使用)は本ピン内では検証できないため、「判定に迷う場合は高位のティアを採用する」ルールに従いオレンジと判定しました。また、外部へのネットワーク送信が存在します。1〜20枚の入力画像 URL は RunComfy サーバーによって取得・推論され(バッチ処理において未公開の SKU や顔画像がサードパーティのクラウドに送信される可能性)、プロンプトは model-api.runcomfy.net 経由で送信されます。画像プロンプトインジェクションのリスクはドキュメント内で自認されています。スキル自体は純粋な Markdown であり、スクリプト、難読化、隠蔽されたエンドポイントは含まれていないため、レッド判定には至りません。

5二重目の独立検証

  • [ok] 端点 ID 与完整 URL 一致(google/nano-banana-2/edit) — description、schema 标题、How-it-works 完整 URL 三处一致,无拼写漂移。
  • [ok] 1–20 输入与 1–4 输出约束在 description/schema/Limitations 三处一致 — description(up to 20 inputs)、schema(1–20 / 1–4)、Limitations(1–20 input images / 1–4 outputs)数字自洽。
  • [ok] 与 image-edit Route 1 的同源关系 — preservation-first 话术、cyberpunk 背景与 AURA 水印示例在 nano-banana-edit 与 image-edit 中逐字一致——确认为同源内容,非本文件独有。
  • [ok] 多语种文字编辑让位 GPT Image 2 / 单参考让位 Flux Kontext 的导流 — When-to-pick 表与 Limitations 两处一致;对应品牌技能 gpt-image-edit/、flux-kontext/ 在仓库内真实存在。
  • [unlocatable] SKILL.md 对 CLI 行为的断言(token 0600、2 GiB、无 shell 展开) — CLI 源码不在本仓库,仅文档自述,无法独立证实。
  • [unlocatable] 『verified to produce strong results』sample prompts — 样例提示词自称 verified,仓内无评测证据可复核。
  • [discrepancy] 身份/安装链接一致性 — SKILL.md 安装与 GitHub 链接指向 agentspace-so/runcomfy-skills,被 pin 镜像为 prime-skills/runcomfy-agent-skills——来源标识不一致(发布身份漂移)。

6結論

  • 卓越したバッチ一貫編集機能(1回あたり1〜20枚 + 先頭画像の優先 + 構図の固定)。リポジトリ内の i2i スキルの中で唯一バッチ処理を最優先機能として扱っています
  • メカニズムの解説に裏打ちされた preservation-first 構文(モデルは前置された保持目標のみを重視する)。単なる抽象的なアドバイスにとどまりません
  • 具体的な空間表現構文(背景、左側の物体、上部の角など)により、再現性の高い局所編集が可能です
  • 誠実な機能境界の定義: 多言語テキスト編集や単一参照の高精度編集は、より適したスキルへ明確に委譲しています
  • 完全な API URL と包括的なセキュリティ自己開示(画像プロンプトインジェクションのリスク警告を含む)を備えた透明性の高い設計です
  • 最適な用途: RunComfy アカウントを保有し、EC サイトの SKU 画像の背景変更/テキスト置換/ウォーターマーク除去、広告 A/B 素材の生成、人物の同一性を保持した背景差し替えなどを行うエージェントやユーザーに適しています。バッチ一貫性(1回最大20枚 + sibling 構文)が最大の強みです。また、nano-banana-2 で生成した画像を仕上げる「生成→編集」パイプラインにも適しています。
    不向きな用途: 多言語(非ラテン文字)の画像内テキスト修正には適していません(GPT Image 2 edit を推奨)。単一画像に対する単一指示の高忠実度な局所編集には不向きです(Flux Kontext がより専門的)。ゼロからの画像生成には適していません(nano-banana-2 t2i を使用)。RunComfy アカウントを持たないユーザー、素材のクラウド送信を許容しないユーザー、信頼できない外部画像を編集する必要があるユーザーには適していません。
    Install Agent-Ready
    ① Verified Mirror 2026-09-09
    Option A · Direct DownloadDownload nano-banana-edit.tar.gz
    sha256: ba0f1dd15b2c6baf…
    Option B · Copy Guide for Agent
    install.json
    Agent はこの JSON ガイドから自動的にダウンロードして検証します。
    ② Upstream GitHub
    GitHub Repo ↗
    Pinned to commit fca19ae084.