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

image-edit

RunComfy 上で画像を編集 — このスキルは、ユーザーの意図を RunComfy カタログ内の適切な編集モデルに適合させるスマートルーターです。Nano Banana Edit(最大20枚の一括処理、デフォルトで同一性保持)、OpenAI GPT Image 2 Edit(多言語の画像内テキスト書き換え、複数リファレンス合成、高精度レイアウト)、Flux Kontext Pro(単一リファレンスによる高忠実度な局所編集)、または Z-Image Turbo Inpaint(マスク駆動による高精度な領域編集)を選択します。各モデルの文書化されたプロンプトパターンをパッケージ化しているため、誤ったモデルで試行回数を浪費することなく、よりシャープな編集を実現します。ローカルの RunComfy CLI を介して `runcomfy run <vendor>/<model>/edit` を呼び出します。「image edit」、「edit image」、「image-to-image」、「i2i」、「swap background」、「remove object」、「rewrite headline」、または単一・一括画像編集の明示的な要求に応じてトリガーされます。

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仕組みと動作原理

4モデル画像編集意図ルーティング(ファミリールーター型):一括同一性保持→Nano Banana Edit(デフォルト)、多言語テキスト書き換え/複数リファレンス合成→GPT Image 2 Edit、単一リファレンス高忠実度局所編集→Flux Kontext Pro、マスク駆動領域置換→Z-Image Turbo Inpaint。エージェントがテーブルを読み取り分類して対応するルートのサブセクションに誘導します。

image-edit/SKILL.md
| User intent | Model | Why | |---|---|---| | Batch edit 1–20 images consistently (SKU gallery, A/B variants) | **Nano Banana Edit** | Up to 20 input images per call; locked aspect/resolution for series |
ルーティングテーブルは全12行の意図 + Default if unspecified → Nano Banana Edit で構成されます。本文の移行文 `The agent reads this table, classifies the user's intent, and picks the matching subsection below.` は video-edit と同一のテンプレートであり、分類はLLMの判断によるものでスキル自体にコードは含まれません。

Route 1(Nano Banana Edit)は単一モデルスキル nano-banana-edit とコンテンツの出所が同一:共通の preservation-first 構文、cyberpunk/AURA のサンプル、image_urls 1–20 のスキーマを持ち、ルーターは単一モデルスキルをデフォルトルートとして統合しています。

image-edit/SKILL.md
**Model**: `google/nano-banana-2/edit`
nano-banana-edit/SKILL.md の Route セクションと比較すると一字一句一致しており(`Keep the subject identity, pose, and clothing unchanged. Convert the background into a rainy neon cyberpunk street.` の例を含む)、相違点として safety_tolerance や limit_generations などの副次的フィールドが省略され、enable_web_search が保持されています。

Route 2(GPT Image 2 Edit)は多言語画像内テキストと複数リファレンス合成に特化:images 配列(≤10、先頭画像がメイン)、4つの固定 size、番号付き refs 構文、逐字引用 + 言語文字指定(Japanese kana/Cyrillic/Arabic right-to-left)。

image-edit/SKILL.md
| `images` | string[] | yes | — | **Up to 10** HTTPS URLs. First is primary; rest are auxiliary. |
プロンプト規律ページでは `Quote in-image text exactly. Name the script for non-Latin` を要求しており、「多言語の組版テキストに最も強い」という製品位置づけを実行可能な記述形式に落とし込んでいます。size の列挙型は auto/1024_1024/1024_1536/1536_1024 の4種類のみです。

Route 3/4 は「単一リファレンス精密編集」と「マスク駆動再描画」という2つの極端なプロトコルの差異をカバー:Flux Kontext は単一 image フィールド + 単一の平叙文指示。Z-Image Inpaint は mask_image(グレースケール規約: white=inpaint/black=preserve)+ strength(0.3–1.0 の階層化セマンティクス)+ control_scale を追加で受け取ります。

image-edit/SKILL.md
| `mask_image` | string | yes | **Grayscale mask URL** (white = inpaint, black = preserve). |
Z-Image の規律ページには strength のセマンティックマッピング(0.3–0.5 retouching / 0.6–0.7 object replacement / 0.8–1.0 full replacement)とマスク境界の 1–3px ぼかし技法が記載されています。これは4つのルートの中で唯一「追加のマスク生成」が必要なワークフローであり、純粋なプロンプト編集との本質的な違いです。

ブランド引き継ぎ境界:ユーザーが特定のモデルを指定した場合は、gpt-image-edit / flux-kontext / nano-banana-edit のブランドスキルに転送してより完全な処理を実行。複数ルートの混在指定は禁止されています。

image-edit/SKILL.md
- **Brand-specific overrides** — if the user named a specific model, route to the corresponding brand skill (`gpt-image-edit`, `flux-kontext`, `nano-banana-edit`) for fuller treatment.
指定された3つのブランドスキルディレクトリはリポジトリ内に実在します。Z-Image には対応するブランドディレクトリが存在せず(override リストにも未掲載)、そのルートモデル tongyi-mai/z-image/turbo/inpainting にはリポジトリ内に単独スキルがありません。

実行委任は runcomfy CLI + クラウド推論:`runcomfy run <model_id>` + 対応する JSON body。CLI が Model API に送信、ポーリング、成果物を --output-dir にダウンロードします。

image-edit/SKILL.md
The skill picks one of Nano Banana Edit / GPT Image 2 Edit / Flux Kontext Pro / Z-Image Turbo Inpaint based on user intent and invokes `runcomfy run <model_id>` with the matching JSON body.
編集の入力(元画像/マスク/参照画像)はすべて外部URLであり、RunComfy サーバーによって取得されます。ローカルマシンは CLI を実行して JSON の送受信と成果物の受け取りのみを行います。

2コア機能

014モデル編集意図ルーティング(一括/多言語テキスト/単一リファレンス/マスク領域)、デフォルトは Nano Banana Edit
021–20枚の画像に対する一貫した一括編集 + アスペクト比/解像度を固定したシリーズ出力
03多言語/非ラテン文字の画像内テキスト書き換えとレイアウトレベルの再配置(GPT Image 2 Edit)
04複数リファレンス合成:番号付き refs ルーティング(例: subject from image 1 / lighting from image 2)
05単一リファレンスによる高忠実度局所編集(Flux Kontext Pro: 単一 image + 単一平叙文指示)
06マスク駆動による精密な領域編集(Z-Image Turbo Inpaint: グレースケールマスク + strength/control_scale の階層設定)

3外部依存関係

KindDependency / Endpoint
cliruncomfy(@runcomfy/cli 官方 CLI)
package@runcomfy/cli(npm 全局安装)
api四个云端编辑模型端点(经 runcomfy CLI + RunComfy Model API)
networkRunComfy Model API(请求提交)与生成结果下载
network用户提供的源图/参考图/mask URL——由 RunComfy 模型服务器抓取
networkRunComfy 模型页 / 文档站(引用链接)

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

安全運用のための推奨統制措置
Agent 向け
段階的・都度認可、サンドボックス推奨
管理者向け
承認フロー、ロールバック可能、全履歴監査
判定根拠(ファイルパスと抜粋)
  • 网络端点: 外部ネットワークアクセスの宣言: model-api.runcomfy.net — 編集リクエストの送信(runcomfy CLI 経由でドキュメントに記載された唯一の送信経路)
  • 本地工作目录: ファイル読み書きおよび成果物出力: CLI は生成結果を --output-dir で指定されたローカルディレクトリにダウンロード(パスは呼び出し側が決定)
  • SKILL.md: ホストの CLI インタプリタまたは外部実行環境の呼び出しを宣言
監査ノート: 今回の統一判定基準に基づく:実行時にサードパーティの npm パッケージ/CLI である @runcomfy/cli を呼び出し、この CLI は呼び出しごとにユーザーの RunComfy 認証情報(~/.config/runcomfy/token.json または RUNCOMFY_TOKEN 環境変数)を読み取るため、「サードパーティ npm/CLI を呼び出し、クォータやキーを読み取る可能性がある → オレンジ」に該当します。実行面(CLI、4モデル API、トークン読み取り)はすべてリポジトリ外にあり、ドキュメントに記載された主張(0600権限、2 GiB上限、シェル展開なし)はこのピン留めでは検証できないため、「不確実な場合は上位の等級を採用する」ルールに従いオレンジと判定します。また、外部送信が存在します:元画像、リファレンス画像、マスクはすべて外部URLであり、RunComfy サーバーによって取得され推論に使用されます(一括処理やマスクワークフローでは未公開 SKU、顔写真、ブランド資産が第三者クラウドに送られます)。これはファミリールーターの中で信頼できない画像との接触面が最も広いスキルであり、画像プロンプトインジェクションのリスクはドキュメント自体も認めています。スキル本体は純粋なマークダウンであり、スクリプト、難読化、隠蔽されたエンドポイントは存在しないため、レッド判定には該当しません。

5二重目の独立検証

  • [ok] 四个 route 模型 ID 与调用示例、schema 一致 — 四条 Route 的 **Model** 行与各自 `runcomfy run` 示例成对出现:google/nano-banana-2/edit、openai/gpt-image-2/edit、blackforestlabs/flux-1-kontext/pro/edit、tongyi-mai/z-image/turbo/inpainting,无悬空引用。
  • [ok] Route 1 与 nano-banana-edit 技能同源 — preservation-first 话术、cyberpunk/AURA 示例、schema 字段与 nano-banana-edit/SKILL.md 逐字一致;此处略去 safety_tolerance/limit_generations 属有意精简,非错误。
  • [ok] 品牌 override 目标(gpt-image-edit、flux-kontext、nano-banana-edit)可达性 — 三个目录在仓库根真实存在;Z-Image 无对应品牌技能且未被列入 override,文档未作虚假承诺。
  • [ok] Z-Image mask 工作流字段与纪律自洽 — mask_image 必填、strength 0.3–1.0 分档语义、control_scale 0.6–0.9 在 schema 与 prompting tips 两处数字一致。
  • [unlocatable] SKILL.md 对 CLI 行为的断言(token 0600、2 GiB、无 shell 展开) — CLI 源码不在本仓库,仅文档自述,无法独立证实。
  • [unlocatable] GPT Image 2 / Z-Image 的能力宣称(Strongest in class for multilingual typography 等) — 路由表 Why 列为站外比较性宣称,pin 内无评测证据可复核。
  • [discrepancy] 身份/安装链接一致性 — SKILL.md 安装与 GitHub 链接指向 agentspace-so/runcomfy-skills,被 pin 镜像为 prime-skills/runcomfy-agent-skills——来源标识不一致(发布身份漂移,非代码缺陷)。

6結論

  • 「背景置換」から「マスク再描画」までの全領域をカバーする4つの編集ルートを備え、デフォルトルートによるフォールバックで複数の機能を一度に導入可能
  • 多言語テキスト編集のための体系化されたプロンプト知識(逐字引用 + 言語文字指定 + レイアウト方向の指示語)
  • マスクワークフローパラメータのセマンティック化:strength の3段階マッピング + マスクエッジのぼかし技術により、試行錯誤のノウハウをエージェントに直接提供
  • 透明性のある制約:各ルートの入力/出力/リファレンス上限が Limitations に明記されており、誇大な万能感を排除
  • ブランド別スキル(gpt-image-edit/flux-kontext/nano-banana-edit)へのシームレスな引き継ぎにより、カタログ内でのリレー連携を形成
  • 最適な用途: RunComfy アカウントを持ち、背景置換、オブジェクト削除、画像内テキスト変更、SKU一括編集、マスク再描画など多様な編集ニーズを単一の窓口で処理したいエージェントユーザーに最適。まずはデフォルトを試し、必要に応じてブランドスキルへ掘り下げる段階的なワークフローに適しており、マーケティング、EC、コンテンツ制作チームによる素材の一括編集の高頻度なエントリポイントとなります。
    不向きな用途: 特定モデルを指定した高度なシナリオ(ルーターは案内に過ぎないため、gpt-image-edit / flux-kontext / nano-banana-edit のブランドスキルを直接利用すべき);ローカルでマスクを生成する必要があるワークフロー(マスクも公開URLである必要があるため);RunComfy アカウントを持たないユーザー、素材のクラウドアップロードを拒否するユーザー、または信頼できない第三者の画像を編集する必要があるユーザー;1回の呼び出しで複数モデルの能力を混合する複合編集(ドキュメントで1回の呼び出しにつき1モデル選択と明記)には不向きです。
    Install Agent-Ready
    ① Verified Mirror 2026-09-09
    Option A · Direct DownloadDownload image-edit.tar.gz
    sha256: 173c3a258c664f4a…
    Option B · Copy Guide for Agent
    install.json
    Agent はこの JSON ガイドから自動的にダウンロードして検証します。
    ② Upstream GitHub
    GitHub Repo ↗
    Pinned to commit fca19ae084.