1仕組みと動作原理
「ノーコード ＋ 外部 CLI への委任」というアプローチで実装されています。flux-kontext/ ディレクトリには SKILL.md が1ファイルあるのみで、スクリプトは含まれていません。唯一のアクションは、ホストエージェントが Bash を使用して `runcomfy run blackforestlabs/flux-1-kontext/pro/edit` を呼び出し、プロンプトとソース画像を JSON 形式にして `--input` 経由でリポジトリ外部の CLI に渡すことです。本スキルの付加価値はコードではなく、モデルのスキーマ、プロンプト手法、およびルーティングの境界をエージェントが直接参照できるドキュメントとして定型化した点にあります。
flux-kontext/SKILL.md
The skill invokes `runcomfy run blackforestlabs/flux-1-kontext/pro/edit` with a JSON body matching the schema.
`git ls-tree HEAD` により、flux-kontext/ 配下には SKILL.md という1つのエントリのみが存在することを確認済みです（リポジトリルートには他に LICENSE、README.md、および31個のスキルディレクトリが存在）。CLI 自体の挙動に関してはリポジトリ内に検証可能なソースコードが存在せず、同一リポジトリ内の runcomfy-cli/SKILL.md がその説明書にあたり、ドキュメントの転述に該当します。
機能はすべてリモートモデルによって実現されます。CLI が RunComfy Model API に JSON を POST し、リクエスト状態をポーリングした上で、ホワイトリストに登録された `.runcomfy.net` / `.runcomfy.com` の URL から生成物を `--output-dir` にダウンロードします。`Ctrl-C` により終了前にリモートリクエストをキャンセルします。
flux-kontext/SKILL.md
The CLI POSTs to `https://model-api.runcomfy.net/v1/models/blackforestlabs/flux-1-kontext/pro/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.
この記述は submit → poll → download の3段階のライフサイクルを明示しており、エージェントが生成物の保存先や中断時の動作を把握できるようにする（無駄な GPU クォータ消費を防ぐ）目的があります。
入力スキーマは意図的に最小限に抑えられています。prompt（必須）、image（必須、一般公開され取得可能な単一の HTTPS URL）、aspect_ratio、seed の4つのフィールドのみで構成されており、「単一参照による局所編集」というモデルの位置付けが入力形状に直接エンコードされ、複数画像や複数参照の要件は明示的に排除されています。
flux-kontext/SKILL.md
| `image` | string | yes | — | Single source image URL (publicly fetchable HTTPS). |
aspect_ratio の行には `Pick from supported W:H options on the model page.` と記載されており、5つのモデルスキルの中で唯一列挙値が提示されていないフィールド定義です（他のスキルでは全列挙値が記載されています。verification.second_pass の discrepancy 項目を参照）。
ドキュメントの主体は API パラメータではなくプロンプト手法にあります。preservation-first（保持する内容を最初に宣言し、その後に変更点を指定する）、単一の平叙文による指示、複合的な編集を連続した複数ステップに分割することを要求しています。
flux-kontext/SKILL.md
**Preservation first.** Lead with `"Keep [identity / pose / framing / brand] unchanged."` Then the change. Models honor what's stated up front.
ここでの狙いは、ベンダーのドキュメントに記載されたノウハウを命令形のルールやアンチパターン一覧に落とし込み、エージェントがモデルに精通していなくても適切なプロンプトを作成できるようにすることです。アンチパターンのセクションでは、「モデルの誤用」（複数画像への展開、元画像がない状態での新規構図の要求など）も同時に除外しています。
ルーティングテーブルによって「どのような場合に使用すべきでないか」もスキル内に規定されています。複数画像のバッチ処理 → Nano Banana Edit、画像内の多言語/埋め込みテキスト → GPT Image 2 edit、元画像なしのゼロからの生成 → Flux 2 Klein へ誘導し、ユーザーから明示的な指定があった場合は無条件で本スキルにルーティングするよう定めています。
flux-kontext/SKILL.md
| Batch edits across 1–20 images | Nano Banana Edit |
指定されている3つのスキルディレクトリ（nano-banana-edit、gpt-image-2、flux-2-klein）はいずれもリポジトリ内に実在します。また、該当ページの末尾には 'If the user said "Flux Kontext" / "kontext" / "BFL Kontext" explicitly, route here regardless.' とあり、意図の分類よりも明示的な指定が優先されるという、一連のスキルファミリー共通のルーティング規約となっています。
失敗時の挙動は sysexits スタイルの終了コード表で定義されており、リトライの判断をエージェントに委ねています。75 = リトライ可能（タイムアウト/429）、77 = 未ログインまたはトークン拒絶、65 = 入力 JSON/スキーマの不一致となっています。
flux-kontext/SKILL.md
| 75 | retryable: timeout / 429 | | 77 | not signed in or token rejected |
同テーブルには 0/64/69 も含まれます。同一リポジトリの runcomfy-cli/SKILL.md にある同様の表には 130（Ctrl-C による中断）の行と「retry?」列が追加されていますが、本スキルの表にはその変更が反映されていません。
制約事項の自己申告：単一ソース画像の制限、公開ドキュメントのスキーマが不完全である可能性、複合プロンプトによるドリフトの発生、多言語埋め込みテキストにおける他モデルへの切り替え推奨など。
flux-kontext/SKILL.md
- **Single source image only.** For multi-image flows, use Nano Banana Edit (1–20).
「ドキュメントが実際の API よりも遅れている可能性がある」（'schema fields beyond prompt + image + aspect_ratio + seed may exist'）という点まで記載されており、このスキル群の中では比較的誠実な記述となっています。
2コア機能
01単一参照による精密な局所画像編集（最小限のスキーマ：prompt + 単一の image、seed/aspect_ratio 指定可能）
02保持優先（preservation-first）の指示記述：Keep [identity/pose/framing/brand] unchanged を宣言した後に変更内容を記述
03ドリフトを低減するための複合編集のステップ分割（背景変更後に服装を変更するなど、ステップごとに単一指示を実行）
04seed による再現可能なバリエーション生成（同一 seed を用いたプロンプト差異の比較検証）
05関連モデルのルーティング判断表（一括処理・多言語テキスト・新規生成に応じたモデル切り替え）
06終了コードのセマンティクス化とリトライ判断（429 やタイムアウトを致命的エラーとして扱わない）
07アンチパターンと制約事項のチェックリスト（複数画像への展開、受動態、元画像なしでの構図要求を不適切な用法として排除）
3外部依存関係
| Kind | Dependency / Endpoint |
|---|---|
| cli | runcomfy（RunComfy 官方 CLI） |
| package | @runcomfy/cli（npm 全局包） |
| package | npx skills（skills.sh 安装器） |
| api | RunComfy Model API（Flux 1 Kontext Pro /edit） |
| network | RunComfy 产物下载白名单 |
| network | 用户传入的源图 URL（由 RunComfy 服务器抓取，非本机） |
| network | RunComfy 站点/文档（文档引用，非运行时调用） |
| network | GitHub（技能源码链接） |
4推奨統制措置と判定根拠
安全運用のための推奨統制措置
Agent 向け
段階的・都度認可、サンドボックス推奨
管理者向け
承認フロー、ロールバック可能、全履歴監査
判定根拠（ファイルパスと抜粋）
- scripts/: ローカルスクリプトまたはコマンドの実行: （スキル本体にスクリプトなし）ホストエージェントが Bash を介して外部 CLI を実行：`runcomfy run <vendor>/<model>/<endp
- 网络端点: 外部ネットワークアクセスの宣言: POST https://model-api.runcomfy.net/v1/models/blackforestlabs/flux-1-kontex
- 本地工作目录: ファイル I/O と成果物の出力: 生成された成果物は外部 CLI によってダウンロードされ `--output-dir` に保存（単一ファイルが 2 GiB を超える場合はディスク枯渇防止のため処理中断と記載）
監査ノート： 今回の統一判定基準（同一リポジトリの image-edit は橙判定）に基づき、実行時にサードパーティ製 npm パッケージ/CLI である `@runcomfy/cli` を駆動し、呼び出しごとにユーザーの RunComfy 認証情報（~/.config/runcomfy/token.json または RUNCOMFY_TOKEN）を読み取るため、「サードパーティ製 CLI/リモートパッケージの呼び出し、かつ認証情報/クォータへのアクセス」の基準に該当します。実行面（CLI 内部実装、Model API、トークン読み込み、2 GiB 制限、0600 権限、シェル展開の有無などの主張）はすべてリポジトリ外にあり、対象コミット内に検証可能なソースコードが存在しないため、「確証が持てない場合は安全側に倒して1ランク上とする」原則に従い橙（Amber）と判定しました。また、素材の外部送信が存在します。ソース画像の URL は RunComfy サーバーに取得されて推論に利用されるため、未公開素材や顔写真の機密性はサードパーティのクラウドに依存します。さらに、呼び出しごとに従量課金が発生します。スキル本体はプレーンな Markdown のみでスクリプトや難読化、隠蔽されたエンドポイントはなく、赤（Red）判定の基準には触れていません。
5二重目の独立検証
- [ok] skill 目录内容 = 仅 SKILL.md（无脚本/引用/模板） — git ls-tree HEAD 与 ls -a 双向核实：flux-kontext/ 下仅 SKILL.md；仓库根为 LICENSE + README.md + 31 个技能目录，无 plugins/、.claude/、scripts/。
- [ok] 外部依赖条目逐个回查调用点 — runcomfy CLI 调用点 2 处（How to invoke 两个示例）、npm 安装 1 处（Prerequisites）、npx skills 1 处（安装行）、model-api 端点 1 处（How it works）、白名单与第三方 URL 抓取各 1 处（Security & Privacy）、文档/模型页/GitHub/skills.sh 链接多处——均实读命中。
- [unlocatable] Security & Privacy 的技术断言可在本仓证实 — token.json 权限 0600、2 GiB 下载上限、CLI 不做 shell 展开、下载白名单、退出码语义，描述的都是仓外 @runcomfy/cli 的行为；仓库内既无 CLI 源码也无版本 pin 引用，只能作为文档自述引用，不能坐实。同仓 runcomfy-cli/SKILL.md 有同一套自述，属同源转述而非独立证据。
- [discrepancy] 安装一行与 GitHub 链接指向旧仓 agentspace-so/runcomfy-skills — SKILL.md 写 `npx skills add agentspace-so/runcomfy-skills --skill flux-kontext -g` 与 github.com/agentspace-so/runcomfy-skills，而本仓储物 pin 在 prime-skills/runcomfy-agent-skills（README 也用 runcomfy-agent-skills）。gh api 核实：agentspace-so/runcomfy-skills 仍存在（5★、最后推送 2026-04-29、同样含 flux-kontext 等目录），是另一份较旧的仓；prime-skills/runcomfy-agent-skills 与 agentspace-so/runcomfy-agent-skills 返回相同 stats、full_name 均为 prime-skills/runcomfy-agent-skills（同一仓的新名）。结论：按文档安装可能装到旧版内容。
- [discrepancy] aspect_ratio 未给枚举值（与同族其他技能不一致） — 本技能写 'Pick from supported W:H options on the model page.'——同仓 happyhorse-1-0/wan-2-7/seedance-v2/gpt-image-edit 都列全了枚举。属于文档详略不一致（未到『错误』程度，但 agent 无法据此校验取值）。
- [ok] prompt 注入面 vs 文档自述 — 正文 'The CLI does NOT shell-expand the prompt' 与 'No shell injection surface from prompt content' 一致陈述；图像侧注入风险在 Limitations/Security 段有自认，未见淡化。
- [ok] 被点名的兄弟技能目录是否真实存在 — nano-banana-edit/、gpt-image-2/、flux-2-klein/ 三个目录经 ls 与 git ls-tree 核实均存在，路由建议不是死链。
- [ok] 无凭证/写入代码路径 — SKILL.md 中 RUNCOMFY_TOKEN 与 token.json 仅出现在 Prerequisites 第 3 条与 Security & Privacy 的 token storage 说明里，均是对 CLI 行为的转述；文件内无 write/save/append 指令指向本地路径，除 --output-dir 产物落地外无写入动作。
6結論
最適な用途： 適した用途：既存の単一ソース画像があり、「特定箇所のみを変更し、他は維持する」精密な局所編集（背景の差し替え、手持ちアイテムの変更、ラベル文字の修正など）を行うエージェントワークフロー。ペア比較において Flux Kontext Pro を「忠実度ベースライン」モデルとして使用する場合（seed を固定してバリエーションを比較）。また、単一ファイル構成、スキーマ・プロンプト手法・ルーティング・終了コード・制約事項の5要素が揃ったスキル作成の見本としても最適です。前提条件として、実行環境に runcomfy CLI がインストールされ、ログイン済みであるか RUNCOMFY_TOKEN が設定されている必要があります（CI 環境など）。
不向きな用途： 適さない用途：複数画像の一括処理やシリーズ全体での一貫した出力（Nano Banana Edit を使用すべき、1〜20枚）、画像内の多言語や長文テキストの書き換え（GPT Image 2 edit の方が適している）、元画像のないゼロからのテキスト画像生成（Flux 2 Klein t2i を使用すべき）。「ローカル推論／データを外部送信しない」ことが求められる環境には不適（本スキルの全処理は RunComfy クラウドを経由します）。スキル自体にスクリプトが同梱されていること、オフライン動作、またはモデル重みの自己保持を期待するユーザーには不適。監査可能な実行コードが求められるコンプライアンス環境にも不適（実行面がリポジトリ外にあり、バージョン固定されていません）。
Install Agent-Ready
① Verified Mirror 2026-09-15
Option A · Direct DownloadDownload flux-kontext.tar.gz
sha256:
Option B · Copy Guide for Agent8c2a39b4f92f3d82…Agent はこの JSON ガイドから自動的にダウンロードして検証します。
② Upstream GitHub
GitHub Repo ↗
Pinned to commit fca19ae084.