1实现原理 · 为什么它能做到
实现方式是「零代码 + 外部 CLI 委托」：flux-kontext/ 目录只有一份 SKILL.md，不含任何脚本；唯一动作是让宿主 agent 用 Bash 调 `runcomfy run blackforestlabs/flux-1-kontext/pro/edit`，把提示与源图打成 JSON 经 `--input` 交给仓外 CLI。skill 的增量价值不是代码，而是把模型的 schema、提示法与路由边界固化成 agent 可直接照抄的文档。
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 一个 entry（仓库根另有 LICENSE + README.md + 31 个技能目录）。CLI 自身行为在仓库内没有源码可核——同仓 runcomfy-cli/SKILL.md 是它的说明书，属于文档转述。
能力完全由远端模型兑现：CLI 把 JSON POST 到 RunComfy Model API，轮询请求状态，再把 `.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 三段生命周期写明，作用是让 agent 知道产物落盘位置与中断语义（避免白烧 GPU 额度）。
输入 schema 刻意最小：只有 prompt（必填）、image（必填、单张公开可抓取的 HTTPS URL）、aspect_ratio、seed 四个字段——「单参考局部编辑」的模型定位被直接编码成输入形状，多图/多参考需求被显式排除。
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.`——五份模型技能里唯一不给枚举值的字段说明（其余技能都列全枚举），见 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.
注：这里在做的事：把厂商文档经验翻译成祈使句规则 + 反模式清单，让 agent 不懂模型也能写对提示；反模式段同时排除了「用错模型」的写法（多图 fanout、无源图求新构图）。
路由表把「何时不该用它」也写进 skill：多图批量 → Nano Banana Edit，图内多语言/嵌入文字 → GPT Image 2 edit，无源图从零生成 → Flux 2 Klein；并规定用户显式点名时无条件路由到本技能。
flux-kontext/SKILL.md
| Batch edits across 1–20 images | Nano Banana Edit |
注：被点名的三个技能目录（nano-banana-edit、gpt-image-2、flux-2-klein）在仓库内均真实存在；同页结尾还有 'If the user said "Flux Kontext" / "kontext" / "BFL Kontext" explicitly, route here regardless.'——显式点名优先于意图分类，是家族统一的路由协议。
失败面用 sysexits 风格退出码表定义，把重试决策交给 agent：75 = 可重试（timeout/429），77 = 未登录或 token 被拒，65 = 输入 JSON/schema 不匹配。
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?」，本技能表未同步该变化。
限制自陈：单源图上限、公开文档 schema 可能不全、复合提示会漂移、多语言嵌入文字应换模型。
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单参考精确局部图像编辑（最小 schema：prompt + 单张 image，可带 seed/aspect_ratio）
02保留优先的指令写法：先 Keep [identity/pose/framing/brand] unchanged，再写改动
03复合编辑拆趟降漂移（先改背景再改服装，逐趟单条指令）
04seed 复现的变体系列（同 seed 比同题变体）
05兄弟模型路由决策表（批量/多语文字/从零生成各自换模型）
06退出码语义化 + 重试判断（不把 429/超时当致命错误）
07反模式与限制清单（多图 fanout、被动语态、无源图求构图均为错误用法）
3外部依赖
| 类型 | 依赖 |
|---|---|
| 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风险提醒 风险提醒：橙色 · 评估后使用
风险提醒：橙色 · 评估后使用
- 执行面完全在仓库外，无法审计 — 真正的动作由 npm 全局安装的 @runcomfy/cli 完成；安装无版本 pin（`npm i -g @runcomfy/cli`），CLI 内部实现、是否读写凭证、下载上限等断言都无法在本 pin 证实（second_pass 记为 unlocatable）。供应链风险落在 npm 与 RunComfy 两方。
- 凭证与计费 — CLI 以用户 RunComfy 账号 token（token.json 或 RUNCOMFY_TOKEN）提交请求；每次调用按次计费，若 agent 依 75 退出码进入重试循环，会在不知情下重复消耗额度。
- 素材外发与肖像/版权 — 源图 URL 由 RunComfy 服务器抓取并进入第三方图像编辑模型，未发布素材/人脸/品牌资产的保密性不由本地控制；生成图可能改写字样（如把 ALPHA 改成 AURA），用于商业素材需自行把关授权。
- 图像提示注入与身份误导 — 文档自认 image-based prompt injection 是图像编辑类模型的已知风险；若源图来自不可信来源，画面内文字可能影响输出；同时『AI 生成』结果可能被误当摄影原片使用（本 skill 不产出任何来源标注或水印说明）。
- 文档漂移 — 文档自认 schema 字段可能比真实 API 少（'schema fields beyond prompt + image + aspect_ratio + seed may exist'），且 aspect_ratio 未给枚举；照文档写死的参数可能被 422 拒绝。另安装一行指向旧仓名，可能装到与 pin 不一致的版本。
风险提醒：橙色，评估后使用。按本次统一分档准则（同仓 image-edit 已取橙）：运行时驱动第三方 npm 包/CLI `@runcomfy/cli`，该 CLI 每次调用读取用户 RunComfy 凭证（~/.config/runcomfy/token.json 或 RUNCOMFY_TOKEN）——命中『调第三方 CLI/远程包且触凭证/配额』档；执行面（CLI 内部实现、Model API、token 读取、2 GiB 上限、0600 权限、无 shell 展开等断言）全部落在仓库外，本 pin 内无源码可核，按『拿不准取高一档』定橙。另存在素材出网：源图 URL 由 RunComfy 服务器抓取并参与推理，未发布素材/人脸的保密性由第三方云决定；每次调用按次计费。skill 本体纯 markdown、无脚本、无混淆、无隐藏端点，未触红档。
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结论
适合：适合：已有单张源图、要做「只改一处、其余保持」的精确局部编辑（换背景、换手持物、改标签文字）的 agent 工作流；适合把 Flux Kontext Pro 作为成对比较中的『保真基准』模型（seed 固定做变体对照）；也适合作为 skill 写作范本——单文件、schema+提示法+路由+退出码+限制五件套齐全。前提是操作者已装好 runcomfy CLI 并登录/配置 RUNCOMFY_TOKEN（CI 场景）。
不适合：不适合：多图批量/系列一致输出（应换 Nano Banana Edit，1–20 张）、图内多语言或长文字改写（GPT Image 2 edit 更强）、无源图从零生成（应用 Flux 2 Klein t2i）；不适合要求『本地推理/数据不出网』的场景——本 skill 的一切都经 RunComfy 云；不适合期望 skill 自带脚本、能离线跑或能自持模型权重的用户；也不适合需要可审计执行代码的合规环境（执行面在仓外且无 pin）。
安装 agent 直装可复制
① 本站镜像 更新 2026-09-15
方式 A · 人下载镜像包下载 flux-kontext.tar.gz
sha256:
方式 B · JSON 格式安装指南，复制给 agent8c2a39b4f92f3d82…agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。
② 上游 GitHub · 原始来源
来源信息 GitHub 原始
作者 / 仓库prime-skills / prime-skills/runcomfy-agent-skills
原始 GitHubprime-skills/runcomfy-agent-skills ↗
Stars48
最近推送2026-05-15
本 skill commit
fca19ae084许可MIT（仓库根 LICENSE：Copyright (c) 2026 RunComfy / agentspace-so；GitHub API spdx=MIT）
本站信息
收录日期2026-09-06
分类内容创作
侦查报告AI 侦查 · 2 遍 · 2026-09-06
本站镜像与 GitHub 原始是不同来源：本站锁定 commit 快照经 /r2 分发；GitHub 为实时上游，内容可能已更新。