1仕組みと動作原理
実装方式は「ゼロコード＋外部CLIへの委任」：gpt-image-edit/ 配下にはSKILL.mdが1ファイルのみ存在し、スクリプトはありません。実行時はホストエージェントがBash経由で `runcomfy run openai/gpt-image-2/edit --input '<JSON>' --output-dir <path>` を実行します。本スキルの付加価値は、GPT Image 2 /edit のスキーマ（3フィールド）と多言語テキスト組版プロンプトの技法をそのまま流用可能なドキュメントとして定型化した点にあり、ローカルでの画像処理は一切行いません。
gpt-image-edit/SKILL.md
The skill invokes `runcomfy run openai/gpt-image-2/edit` with a JSON body matching the schema.
`git ls-tree HEAD` にて gpt-image-edit/ 配下に SKILL.md のみが存在することを確認済み。同リポジトリの runcomfy-cli/SKILL.md はCLI自体のマニュアルであり、本スキルは単一モデルのラッパーに特化しています。
スキーマは3フィールドのみ：prompt（必須）、images（string[]、公開HTTPS URLを最大10枚、先頭がメインで残りは補助参照）、size（auto / 1024_1024 / 1024_1536 / 1536_1024）。極限まで削ぎ落とされたフィールド定義により機能差はすべてプロンプトに委ねられるため、ドキュメントは記述手法の解説に注力しています。
gpt-image-edit/SKILL.md
| `images` | string[] | yes | — | **Up to 10** publicly-fetchable HTTPS URLs. First is primary; rest are auxiliary. |
「最大10枚の参照画像」は、Flux Kontext（単一画像）に対する本スキルの核となる差別化要素です。同ページには size=auto の推奨理由（入力アスペクト比の維持）も記載され、列挙値以外は422エラーになる旨が明記されています。
中核コンテンツは「多言語画像内テキスト組版」の実践手法です。文字を一字一句正確に引用し、文字体系（Japanese kana / Cyrillic / Arabic right-to-left）を明示する必要があり、言い換えは厳禁です。この規律こそが、多言語広告のローカライズ領域において同種モデルを凌駕する理由となっています。
gpt-image-edit/SKILL.md
**Multilingual text — quote the characters, name the script.** `"the headline reads \"コーヒー\" in bold Japanese kana"`, `"the label says \"АРОМА\" in Cyrillic, white on black"`, `"the right-margin caption reads \"تخفيض\" in Arabic right-to-left"`. Don't paraphrase — quote.
付随するアンチパターンにも、「画像内テキストを引用せず言い換える → 異なるテキストが出力される」という落とし穴が明記されており、失敗パターンと正しい記述手法が対で示されています。
マルチリファレンス合成は「番号指定参照」により手がかりを振り分けます。複数の images を番号で参照（subject from image 1, lighting from image 2, color palette from image 3）することで、モデルが各画像の役割を適切に割り当てます。
gpt-image-edit/SKILL.md
**Multi-ref numbering.** When passing multiple `images`, refer to them by number: `"subject from image 1, lighting from image 2, color palette from image 3"`. The model routes cues correctly.
この点は flux-kontext の「単一参照」規律と明確に対比をなしており、同ファミリーのテンプレートが入手形状によって2つのモデルの能力境界を明確に規定しています（≤10枚 vs 単一画像）。
局所的な空間編集には方向を表す言語表現を用います。「move the headline from top-right to bottom-center」「remove the leftmost object only」「replace the watermark in the bottom-right corner」など、レイアウト変更を判定可能な空間指示として記述します。
gpt-image-edit/SKILL.md
**Directional language for spatial edits.** Concrete spatial scopes work: `"move the headline from top-right to bottom-center"`, `"remove the leftmost object only"`, `"replace the watermark in the bottom-right corner"`.
このような「判定可能な位置指定フレーズ」は、同族ドキュメントの中で唯一「レイアウト再配置」をカバーする記述であり、Nano Banana Editのバッチ同一性保持と相互補完の関係にあります。
ルーティングテーブルは兄弟モデルを4つの用途に分類し（バッチ ≤20 → Nano Banana Edit、単一参照の高忠実度 → Flux Kontext、ゼロからの生成 → 同リポジトリの gpt-image-2 スキル、バッチSKU → Nano Banana Edit）、制限事項セクションでは人物の写実性が Nano Banana Pro に劣る旨を率直に記載しています。
gpt-image-edit/SKILL.md
| Generate from scratch with GPT Image 2 | sibling [`gpt-image-2`](../gpt-image-2) skill |
相対リンク `../gpt-image-2` は同リポジトリ内のディレクトリを指しています（存在確認済み）。同ファミリーの他4つとは異なり、本スキルの表後には明示的な指定時に無条件で本スキルを維持する「route here regardless」の記述がありません（second_pass の discrepancy 参照）。
実行チェーン：CLIがJSONをRunComfy Model APIの `/v1/models/openai/gpt-image-2/edit` にPOSTし、ポーリング完了後にホワイトリスト登録された `.runcomfy.net` / `.runcomfy.com` の生成物を `--output-dir` にダウンロードします。Ctrl-C でリモートリクエストをキャンセル可能です。
gpt-image-edit/SKILL.md
The CLI POSTs to `https://model-api.runcomfy.net/v1/models/openai/gpt-image-2/edit`, polls the request, fetches the result, and downloads any `.runcomfy.net`/`.runcomfy.com` URL into `--output-dir`. `Ctrl-C` cancels the remote request before exit.
編集に必要な複数のソース画像はRunComfyサーバー側が取得（ローカルからのアップロードではない）するため、素材の機密性はサードパーティのクラウド環境に依存します。
2コア機能
01多言語／画像内埋め込みテキストの書き換え（逐字引用＋文字体系の明示指定）
02最大10枚の画像によるマルチリファレンス合成（1枚目が主、残りは補助、インデックス番号で指定）
03元画像保持を最優先した局所編集（「Keep [face/pose/clothing/brand/framing] unchanged」を先に宣言してから変更内容を記述）
04レイアウト単位のピンポイント再配置（方向言語：top-right → bottom-center、最左の物体のみ削除、右下の透かし置換）
05出力寸法の制御（size=auto による入力比率の維持、3種の固定プリセット選択肢、非列挙値は422エラー）
06素材を跨いだブランド／アイデンティティの保持（同一ビジュアル資産から多言語ヘッドラインのバリエーションを生成）
07兄弟モデル間のルーティング判定（バッチ ≤20 → Nano Banana Edit、単一参照 → Flux Kontext、ゼロから生成 → gpt-image-2、人物の写実性 → Nano Banana Pro）
08終了コードのセマンティクスと再試行判定（65: スキーマ不一致、75: 一時的エラー/再試行可能、77: 再認証が必要）
3外部依存関係
| Kind | Dependency / Endpoint |
|---|---|
| cli | runcomfy（RunComfy 官方 CLI） |
| package | @runcomfy/cli（npm 全局包） |
| package | npx skills（skills.sh 安装器） |
| api | RunComfy Model API（OpenAI GPT Image 2 /edit） |
| network | RunComfy 产物下载白名单 |
| network | 用户传入的源图/参考图 URL（最多 10 张，由 RunComfy 服务器抓取，非本机） |
| network | RunComfy 站点/模型页/文档（文档引用，非运行时调用） |
| network | GitHub（技能源码链接） |
4推奨統制措置と判定根拠
安全運用のための推奨統制措置
Agent 向け
段階的・都度認可、サンドボックス推奨
管理者向け
承認フロー、ロールバック可能、全履歴監査
判定根拠（ファイルパスと抜粋）
- scripts/: ローカルスクリプトまたはコマンドの実行: （スキル本体にスクリプトなし）ホストエージェントがBash経由でリポジトリ外のCLIを実行: `runcomfy run <vendor>/<model>/<endpoint>`
- 网络端点: 外部ネットワークアクセスの宣言: POST https://model-api.runcomfy.net/v1/models/openai/gpt-image-2/edit（runcomfy CLI経由）
- 本地工作目录: ファイルの読み書きと成果物の出力: 生成物はリポジトリ外のCLIによりダウンロードされ `--output-dir` に書き込まれる（ディスク容量枯渇防止のため、単一ファイルが2 GiBを超えると中止される仕様）
監査ノート： 今回の統一判定基準に基づく評価（同リポジトリの image-edit もAmber判定済み）：ランタイム時にサードパーティ製npmパッケージ／CLIである `@runcomfy/cli` を呼び出し、実行ごとにユーザーのRunComfy認証情報（~/.config/runcomfy/token.json または RUNCOMFY_TOKEN）を読み取るため、「サードパーティ製CLI／外部パッケージを呼び出し認証情報やクォータに触れる」基準に該当します。CLIの実装、Model APIの挙動、0600パーミッション、2 GiB上限、終了コードのセマンティクス等の主張はすべてリポジトリ外にあり、本コミット内には監査可能なソースコードが存在しないため、「判断に迷う場合は高位ランクを採用する」原則に基づきAmberと判定します。また、複数の画像素材が外部送信され（最大10枚がサードパーティサーバーに取得され推論に使用される）、未公開のブランド資産・顔写真・レイアウトの機密性をローカルで制御できない点、および呼び出しごとに従量課金が発生する点も考慮しています。スキル本体は純粋なMarkdownであり、スクリプトや難読化、隠蔽されたエンドポイントは含まれないため、Red判定には至りません。
5二重目の独立検証
- [ok] skill 目录内容 = 仅 SKILL.md — git ls-tree HEAD 与 ls -a 双向核实；仓库根仅 LICENSE + README.md + 31 个技能目录，无 scripts/、plugins/、.claude/。
- [ok] 全部外部依赖条目回查调用点真实存在 — runcomfy CLI 调用点 3 处（单参考/多语文字/多参考示例）、npm 安装 1 处、npx skills 1 处、model-api 端点 1 处、白名单与外部 URL 抓取各 1 处、文档/模型页/GitHub 链接多处，均实读命中。
- [discrepancy] 路由兜底句 'route here regardless' 缺失（家族内不一致） — flux-kontext / wan-2-7 / seedance-v2 / happyhorse-1-0 四份在路由表后都有 'If the user said ... explicitly, route here regardless.'，本技能的路由表直接接 ## Prerequisites，无该兜底句（触发词仅存在于 frontmatter description 的 'Triggers on ...' 列表）。后果：当用户说『用 GPT Image 编辑这张图』时，是否优先于同族 router 的意图分类由宿主自行判断，家族内无统一行为。
- [ok] size 枚举与 warning 口径一致 — schema 行列出 auto/1024_1024/1024_1536/1536_1024；正文 'Use `size: "auto"` to preserve input ratio' 与 'asking for `size` outside the 3 fixed values + auto → 422'、Limitations 'size: 3 fixed values + auto — anything else 422s' 三处一致（3 个固定值 + auto 的说法自洽）。
- [unlocatable] Security & Privacy 的技术断言可在本仓证实 — 0600 token 权限、2 GiB 下载上限、无 shell 展开、下载白名单、退出码语义均为仓外 @runcomfy/cli 行为；仓内无 CLI 源码或版本 pin，只能作为文档自述引用（同仓 runcomfy-cli/SKILL.md 为同源转述，非独立证据）。
- [discrepancy] 安装一行与 GitHub 链接指向旧仓 agentspace-so/runcomfy-skills — 安装行 `npx skills add agentspace-so/runcomfy-skills --skill gpt-image-edit -g` 与 GitHub 链接 github.com/agentspace-so/runcomfy-skills 均指向旧仓；本仓 pin 在 prime-skills/runcomfy-agent-skills（README 用 runcomfy-agent-skills）。gh api：agentspace-so/runcomfy-skills 仍存在（5★、pushed 2026-04-29、含 gpt-image-edit 目录）；prime-skills/runcomfy-agent-skills 与 agentspace-so/runcomfy-agent-skills 为同一仓（相同 stats，full_name=prime-skills/runcomfy-agent-skills）。按文档安装可能装到旧版。
- [ok] 多语言字符引用写法可执行性 — 正文给出的日文假名（コーヒー / 今日のおすすめ）、西里尔（АРОМА）、阿拉伯（تخفيض）样例在文件内为真实 UTF-8 字符；配套反模式（paraphrase → text comes out different）同页存在，属可执行指引。
- [discrepancy] 未声明 allowed-tools（执行面未收窄） — frontmatter 无 allowed-tools；同仓 runcomfy-cli/SKILL.md 声明 `allowed-tools: Bash(runcomfy *)`。家族内部工具权限声明不一致。
6結論
最適な用途： 最適：多言語広告のローカライズ（同一ビジュアル資産を流用した異なる言語の画像内ヘッドライン差し替え）、ブランドセーフなヘッドライン／CTAの置換、レイアウト単位の再配置（コピーの移動、物体の削除、透かしの除去）、および複数参照画像を組み合わせた合成タスク（画像1から人物を、画像2から背景を抽出）。前提条件として、runcomfy CLI のインストールとログイン（または RUNCOMFY_TOKEN の設定）が必要です。
不向きな用途： 不適：一貫性が求められる20枚以下のバッチ編集（Nano Banana Edit を推奨）、単一参照で元画像の忠実性を追求する局所微調整（Flux Kontext がより適合）、元画像なしでゼロから生成する用途（同リポジトリの gpt-image-2 t2i を推奨）、人物の極限の写実性を求める場合（ドキュメント内でも Nano Banana Pro の優位性を認めている）。また、データ外部送信が禁止されている環境や、監査可能な実行コードが要求されるコンプライアンス環境には適しません（実行基盤がリポジトリ外にありバージョン固定されていないため）。
Install Agent-Ready
① Verified Mirror 2026-09-15
Option A · Direct DownloadDownload gpt-image-edit.tar.gz
sha256:
Option B · Copy Guide for Agentc5a2b82fedddc872…Agent はこの JSON ガイドから自動的にダウンロードして検証します。
② Upstream GitHub
GitHub Repo ↗
Pinned to commit fca19ae084.