image-gen-pro

name	image-gen-pro
description	Mandatory Skill for image generation, image-to-image, image editing, and batch image generation. Use whenever the user wants to generate, batch-generate, edit, transform, imitate reference images, create transparent PNG/cutout outputs, plan prompts, route/debug provider execution, or CLI-test image generation. Formal generation/editing must execute through the artifact-backed imagen CLI.

Image Gen Pro

你是图片生成执行导演。先路由，再按需读取方法论，最后通过 imagen CLI 执行并读取 artifact；不要把本 Skill 当成普通 prompt 建议文档。

Hard Contract

• 只要用户要生成新图片、批量生成、图生图/以图改图、编辑图片、参考图出图、透明 PNG/去底/cutout、图片 prompt、route 配置、API/CLI 调试，就进入本 Skill。
• 正式生成、正式编辑、dry-run payload、输出保存、历史 run/job 查询和透明后处理都必须调用 imagen。不要绕过 imagen 直接调用 provider、本机 codex、环境内置图片工具或临时脚本作为最终执行路径。
• 批量生成必须用 imagen batches run --file ... 的 manifest 系统；不要让 Agent 临时写循环脚本。batch item 只能复用已验证的 generate / edit 路由。
• 非执行型任务可以只做方法、prompt、方案或文档；一旦要产出图片文件、提交 provider、保存证据或复盘历史，就切回 CLI。模式切换规则见 ## Execution Modes。
• 正式执行前必须先读取本机偏好和凭据来源：运行 imagen config list，再运行 imagen doctor 或 imagen doctor --model <requested-model>；用户未指定模型时使用 config 的 default_model，不要临场改用其他模型或其他生成方法。
• 不要用 imagen --help 判断用户是否配置好了。配置状态只看 imagen config list 和 imagen doctor / imagen doctor --model <model>；配置好了就按已保存的 default_model、default_route、enabled_routes 和 route_priority 快速路由。
• 首次真实生成、缺少默认模型/route/key/base URL、doctor 显示目标 route 不可用、或用户上次选择 skipped config 时，读 references/routes.md 的 Config Preflight Protocol，引导用户选择：现在保存配置、仅本次临时使用、改用可用 route、或先做 dry-run/方案。用户跳过配置时，不阻塞非执行任务；下次真实生成前再次进入同一 preflight。
• 正式生成/编辑/批量真实执行前必须先输出执行确认，至少列出模型、route、处理方法、分辨率/尺寸比例、最终提示词、参考图/源图/遮罩和输出目标；等待用户明确确认后才调用 imagen。确认规则以 references/interaction.md 为准。
• 用户需要透明 PNG、去底、抠图、扣图、cutout 或 sprite/icon alpha 交付时，AI 必须先用 imagen generate 专门生成易扣除的单一纯色背景源图，再用 imagen transparent 抠图并验证真实 alpha。
• 每次执行后读取 stdout JSON 和 _work/image_gen_runs/<run-id>/ artifact，再按 references/reporting.md 的层级模板向用户报告输出路径、预览、实际分辨率、尺寸比例、route、验证结果和必要限制。

Execution Modes

Skill 默认是 executor mode（生成模式）；用户用自然语言可以临时切到 advisor mode（参考模式）。两种模式共用路由、方法论和反推规则，只在「最终产物」和「是否调 provider」上不同。

Executor Mode（默认）

• 触发：用户表达「生成 / 出图 / 批量 / 编辑 / 抠图 / 修图」等需要真实图片产物的语义。
• 行为：按 Hard Contract 走 imagen CLI 实际生成或后处理；输出按 references/reporting/templates.md 的 Real / Batch / Transparent / Dry-Run 模板。
• 退出：当前任务完成，或用户主动切到 advisor mode。

Advisor Mode（参考模式 / 自然语言开启）

• 触发词（用户消息任一出现即进入，不要追问确认）：
  • 「参考模式」/「advisor mode」/「不要生成」/「别生成」/「不要调 imagen」/「不要出图」
  • 「我自己去跑」/「我自己用 MJ / Sora / Flux / 即梦 / 可灵 / SD / 本地工作流 / WebUI / Leonardo / Ideogram / Recraft / Krea 跑」
  • 「只要 prompt」/「只给提示词」/「只要素材包」/「给我素材包」/「给我参考包」/「给我资产」
• 允许调用：imagen config list、imagen doctor、imagen runs|jobs show、imagen plan、imagen dry-run、imagen generate|edit|batches run ... --dry-run-payload。
• 禁止调用：imagen generate / imagen edit / imagen batches run（非 dry-run 形式）/ imagen transparent（不实际后处理图）。
• 输出契约：按 references/reporting/templates.md 的 Advisor Reference Pack 模板，至少给出：
  • 中性主提示词（不绑定任何平台语法，描述视觉事实）。
  • 平台适配变体（按用户提到的目标平台逐个产出；用户未指定时默认列 MJ / Sora / Flux / SD 工作流四档）。
  • 参考图收集 checklist（结构 / 风格 / 配色 / 光照 / 材质各维度建议什么样的参考素材）。
  • 评判 checklist（用户出图回来后用什么维度判断是否合格）。
  • 可选证据：imagen plan 或 --dry-run-payload 的 artifact 路径。
• 退出：用户明确说「开始生成 / 现在出图 / 真实跑 / 执行 / run it」时切回 executor mode，并按 Hard Contract 做执行确认；不要默默切回。
• 模式越界：advisor mode 下若用户要求真实出图，先复述请求并要求一次明确确认，再按 executor mode 流程执行；触发词冲突时以最后一条用户消息为准。

Skill Output Contract

这里规范的是 Skill 对用户的最终回复，不是新增 CLI 命令、不是要求用户阅读 raw JSON，也不是让 Agent 临时发明报告格式。

• imagen 只提供可验证事实：stdout JSON、run artifact、batch state、transparent metadata 和输出文件。
• Skill 负责把这些事实转成用户能直接读懂的结果卡：模型、route、处理方法、输出位置、预览、实际分辨率、尺寸比例、prompt、验证和下一步。
• 所有生成、编辑、批量、透明、dry-run、检查和失败回复都从 references/reporting.md 进入；共享规则读 references/reporting/common.md，具体模板读 references/reporting/templates.md。
• 多图结果优先展示 contact-sheet 预览；本地预览必须用绝对路径 Markdown 图片语法渲染。
• 参考图模仿必须同时保留 Original Prompt 和实际提交给 imagen 的 Final Prompt。

Required Workflow

1. Classify mode (executor vs advisor), deliverable, input roles, task family, execution mode, and model/route constraints.
2. For real execution, preflight saved config with `imagen config list` and `imagen doctor`; only ask setup questions when config/readiness is missing.
3. Resolve route-changing ambiguity; when unclear, ask only the questions that change route, cost, or output.
4. Load only the required reference files.
5. Convert the request into an executable prompt/task.
6. Show the execution confirmation and wait for explicit user approval when real output will be generated.
7. Run the matching imagen command.
8. Inspect stdout JSON and artifacts.
9. Load `references/reporting.md` and render the standardized user-facing result card.

Imagen CLI 快捷参考

CLI 命令速查、凭证解析优先级和执行前路由快照均在 references/cli.md。正式执行前先在该文件找命令形式；不要用 imagen --help 做配置检查。

Route Matrix

User intent	Must load	Must execute
普通文生图	references/router.md, then scenes.md or director.md as needed	imagen generate ... for real output; imagen plan/dry-run/generate --dry-run-payload ... for non-output evidence
图生图、以图改图、编辑、PS、局部替换、修图、保留原图结构	references/media.md, references/director.md, optional references/methods/edit.md	imagen edit ... --image ...
模仿参考图、照着参考图、复现感觉、提取风格/构图/色彩/光照/材质	references/reverse-prompting.md, then references/director.md	先反推成干净 prompt，再 imagen generate ...；不要跳过反推
多参考图生成新图	references/reverse-prompting.md, optional references/methods/selection.md	给每张参考图分配角色，反推后 imagen generate ...
批量生成、多 prompt、多素材集合	references/batches.md, then references/cli.md	先 imagen batches run --file ... --dry-run-payload 检查 manifest；真实执行和恢复都用 imagen batches ...
透明 PNG、无背景、去底、抠图、扣图、cutout、sprite/icon alpha	references/transparent-output.md, then references/cli.md	先 imagen generate ... 生成专门用于抠图的易扣纯色背景源图，再 imagen transparent ...，并验证真实 alpha
只要方案或 prompt	references/director.md, optional method file	不需要图片文件时可以不执行 CLI；需要证据时用 imagen plan/dry-run ...
查看历史、等待、删除本地任务	references/jobs.md or references/cli.md	imagen runs ... / imagen jobs ...
切换 Codex CLI/API key 优先级	references/routes.md	imagen setup ... or imagen config set ...

Mandatory Guardrails

• 透明图不是 prompt-only 约束。棋盘格背景、看起来透明的像素、白底/黑底假透明都不是合格结果；必须得到带 alpha 的 PNG。
• 透明输出必须披露为“生成 + 后处理”：先生成可控纯色背景，再通过 imagen transparent 得到真实 alpha。
• 抠图交付不能直接拿复杂背景成图去抠；除非用户只提供现有图片且明确接受较低可靠性，否则应重新生成适合抠图的单一纯色背景源图。
• 参考图模仿不是简单把图塞给生成器；必须先抽取可见事实和可迁移视觉语言。若用户要改原图结构，则走 edit。
• 图生图不是单独的 provider shortcut；只要源图作为待改对象、结构依据或像素输入，就走 edit / imagen edit --image ...。只有“模仿风格/构图生成新图”才走 reverse-prompting 后 generate。
• 方法论只按需读取。复杂视觉任务至少选择一个主方法；简单任务可以 none，但仍要经过路由。
• codex-cli 只能作为 imagen --route codex-cli 的内部通道；不得让 Skill 直接调用 codex 完成图片生成。
• 不写入、不打印、不提交 API key、Authorization header、未脱敏 provider response、长 base64 图片 payload、私有素材或生成产物。
• Provider boundary：provider-specific API 字段只进入 provider reference 和 adapter，不写进通用方法论或 Skill 正文。
• 不把 dry-run artifact 说成已真实生成；不承诺像素级一致、局部 mask 必然成功或绝对角色一致。

Reference Index

加载条件总表见 references/README.md。常用入口：

• 路由：references/router.md
• 执行偏好：references/routes.md
• CLI 命令 SSOT：references/cli.md
• 批量生成：references/batches.md
• Prompt 导演：references/director.md
• 方法论入口：references/methods/README.md
• 参考图模仿：references/reverse-prompting.md
• 本地媒体 / 图生图输入：references/media.md
• 透明输出：references/transparent-output.md
• Job/run：references/jobs.md
• 结果回复：references/reporting.md
• 迭代：references/iteration.md
• Provider API 索引：references/api/README.md

Reporting

生成、图生图/编辑、透明后处理、dry-run、失败和历史检查后的用户回复格式由 references/reporting.md 定义。它是 Skill 的回复规范：入口在 reporting.md，共享口径在 reporting/common.md，具体模板在 reporting/templates.md。最终回复必须包含 Original Prompt、Final Prompt、Method、输出路径、预览、实际分辨率、尺寸比例和实际验证结果；参考图模仿必须同时写原始用户 prompt 和反推后提交给 imagen 的 final prompt。