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` です。
| `image_urls` | array | yes | — | **1–20** publicly-fetchable HTTPS URLs. |
第一プロンプト原則 = 保持優先(preservation-first): 変更内容を記述する前に、まず「Keep [identity/pose/clothing/brand/framing] unchanged」を前置します。ドキュメントにはそのメカニズム上の理由(モデルは前置された保持対象のみを厳密に考慮する)も明記されています。
**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.
空間表現による局所編集の実現: 「background only」、「the left object」、「upper-right corner」などの具体的な空間指定をモデルは正確に認識します。一方、「make it more X」といった曖昧な指示は意図しないブレの原因となります。
**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.
バッチ一貫性の規律: シリーズ編集では `aspect_ratio` + `resolution` を固定し、同一のプロンプト構文を使用することで、バッチ出力を単なるリミックスではなく「兄弟(sibling)」アセットとして揃えます。また、複雑な編集は複合指示として一度に行わず、小さなステップに分解して反復します。
**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.
境界とルーティング: 多言語の画像内テキスト編集は明確に GPT Image 2 edit に委譲し、単一参照の高精度な局所編集は Flux Kontext に、ゼロからの生成は兄弟モデルの nano-banana-2 t2i に委譲します。本スキルは万能性を標榜しません。
| Edit multilingual text inside the image (signs, labels) | GPT Image 2 edit |
runcomfy CLI + クラウド推論への実行委任: `runcomfy run google/nano-banana-2/edit --input '{...}' --output-dir` を実行し、CLI が完全な API URL へ POST リクエストを送信し、ポーリングして結果をダウンロードします。
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`.
2コア機能
3外部依存関係
| Kind | Dependency / Endpoint |
|---|---|
| cli | runcomfy(@runcomfy/cli 官方 CLI) |
| package | @runcomfy/cli(npm 全局安装) |
| api | Google Nano Banana 2 图生图编辑端点(RunComfy Model API 托管) |
| network | 生成结果下载白名单 |
| network | 用户提供的 1–20 张输入图 URL——由 RunComfy 模型服务器抓取 |
| network | RunComfy 模型页 / 文档站(引用链接) |
4推奨統制措置と判定根拠
- 网络端点: 外部ネットワークアクセスの宣言: model-api.runcomfy.net/v1/models/google/nano-banana-2/edit — 編集リクエストの送信(runcomfy CLI 経由)
- 本地工作目录: ファイル I/O および成果物の出力: CLI が生成結果を --output-dir で指定されたローカルディレクトリにダウンロード(パスは呼び出し側が決定)
- SKILL.md: ホストの CLI インタプリタまたは外部実行環境の呼び出しを宣言
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結論
ba0f1dd15b2c6baf…