Imported from GiMi-Xiaomi/gimi-illustration-skill (SKILL.md). Install upstream with npx skills add GiMi-Xiaomi/gimi-illustration-skill. Copyright stays with the author.

gimi-illustration · 配图 Skill

Public 3.0 = 产品 v3.0（多风格：怪诞手绘 / 暖调绘本 / 产品方案 + 自定义 IP）

换窗口：有 docs/ 时先读 docs/INDEX.md → docs/roadmap.md；执行以本文件 + references/ip/_template.md 为准

⚠ 路由分流（先读 · 防 ImageGen 抢跑）

触发含 自定义 IP / 录入 IP / 上传形象 / 新建 IP（可附图）时：

1. 立刻加载 references/ip/_template.md，走 Step 0；不要先当「配图 / 海报」生图
2. 本回合禁止调用任何生图工具（image_gen / GenerateImage / ImageGen 等），直到用户已回答「按这个形象方案录入吗？」
   • 半身/全身相同：首轮只出形象方案 + 收尾问；零例外
   • 确认后：半身才允许 0.2b 全身设定稿；再 0.4 校准
3. 禁止把录入理解成「生成一张 IP 主题海报 / 原创插画海报」
4. 细则与话术以 _template 为准；本段与之冲突时，以本段路由为准（先拦抢跑）

触发仅为 配图 / illustration 等、且非录入 IP → 走下方 Quick Mode / Step 1–5。

输入文章内容，生成配图。默认风格「怪诞手绘」（quirky-sketch），可切换已录入风格（如「暖调绘本」）；IP 为 gimi / none / 自定义实例，默认 16:9。

触发词

配图：配图 / 给文章配图 / 帮我配图 / illustration
自定义 IP：自定义 IP / 录入 IP / 上传形象 / 新建 IP

参考文件（按需加载）

生图能力

调用当前 AI 软件内置的生图工具（如 Codex @Image Gen、Cursor GenerateImage 等）。Skill 负责策略、prompt 组装、参考图附件、QA；生图由平台工具执行。接口语义：文本 prompt + 可选图片附件。

Step 0 录入中： 遵守文首「路由分流」；未满足允许条件前不得调用生图工具。

平台适配优先级：

1. 支持显式图片附件的平台：把参考图作为 image reference 附件传入。
2. Codex image_gen：已有 IP 的正式配图一律传「设定图 + 当前 (IP, STYLE) 校准图」；先跑 Step 1.5，缺任一张不得生正式图；再 image_gen
3. 不支持图片输入且无法把图片放入上下文时，暂停说明原因；已有 IP 不得降级为仅文字锚点的正式配图。

核心变量

推荐像素（非强制）： 16:9 → 建议 1920×1080；3:4 → 建议 1080×1440。

工作流

Quick Mode

用户已给正文且变量可推断 → 不多问，直接生图。以下情况才确认：用户说「先别生图」、变量冲突、新 IP 尚无 ip.md（先走 Step 0）、或 Step 1.5 判为 lazy。 Step 0 进行中：关闭 Quick Mode（不得跳过确认话术）。
录入触发词出现时：不适用 Quick Mode 生图。

Step 0 · 自定义 IP（按需）

用户要新建/录入 IP 时：加载 references/ip/_template.md，严格按其中 Step 0 填槽（用户只需附图 +「录入 IP」，不必写 Step 编号）。
双层： 协议走 0.1–0.5；对用户只用「用户层话术」（见 _template），称当前 $STYLE 的 display_name（录入默认多为「怪诞手绘」），不暴露 Step 编号。

硬门禁（0.5 完成前）——与文首路由分流一致：

1. 入口（半身/全身相同）：首轮只出形象方案 +「按这个形象方案录入吗？」；一律禁生图；禁海报式成稿
2. 禁止配图抢跑：不得进 Step 1–5；不得写 shot-config.md
3. 出图后必须提问：同轮追加收尾问；图 ≠ 闭合（仅 0.2 确认之后才允许生图）
4. 半身：确认后 0.2b 须头到脚；落盘 reference-character.png 一律 full
5. 0.4 标准风格样板镜（读 styles/{$STYLE}.md）；「像吗？」未闭合前不得进配图

examples/{$STYLE}/ 空且要用该风格配图时 → lazy 补 0.4（已启用，见 _template 多风格细则）。
完成后才进入配图；配图时 $IP={id}。

Step 1 · 意图确认

记录：$RATIO · $IP · $STYLE · $TITLE · $COUNT ·（可选）$OUTPUT_SIZE

Quick Mode 推断：竖版/小红书 → 3:4；否则 → 16:9。

$STYLE 解析（主人语言，不要求用户写 id）：

1. 扫描 references/styles/*.md（排除 _template.md）的 display_name / aliases
2. 明确命中 → 锁定对应 id
3. 软命中 → 一句确认（例：「你是说「暖调绘本」那种纸纹暖色吗？」）
4. 未命中或「换个风格」→ 人情味菜单：每项 display_name + tagline（默认可标「常用」）
5. 未提风格 → quirky-sketch；本会话首次配图追加一句轻提示（不打断）：
   「这次先用怪诞手绘。若想换成暖调绘本（纸纹暖色、旅行手帐感），直接说就行。」
6. 用户描述未录入风格 → 不现场发明；说明目前仅已录入风格，问用默认或以后再录

口语优先；$STYLE=… 仅进阶。对用户称 display_name，不说路径。

Step 1.5 · 当前参考解析（IP 与无 IP）

在进入 Step 2、写 shot-config.md 或生成正式图之前，对当前 (IP, STYLE) 只判一次：

1. $IP=none 且当前风格「无 IP 校准策略」为 required style-single → 必须按 references/ip/none.md 选择 assets/none/examples/{$STYLE}/ 中 1 张，记为 $REF_MODE=style-single；缺目录 / 缺选图是发布包资产问题，停止并修复，不向用户索图、不降级为纯文本。
2. $IP=none 且当前风格没有 required 策略 → $REF_MODE=none，保持既有 none 行为；若该风格声明 optional 且有资产，可按 none.md 选 1 张作质量收敛。
3. 已有全身设定图且 assets/ip/{$IP}/examples/{$STYLE}/ 至少有 1 张可用校准图 → $REF_MODE=dual，可进 Step 2。
4. 已有全身设定图但当前风格校准目录为空 / 缺文件 → $REF_MODE=lazy；只按当前风格 0.4 生成样板，QA 后问「像吗？」；禁止写 shot-config.md、生成正式图、或附其他风格校准图充当双参考。用户催图也不降级；应说明「这个风格的样板还没定，确认样板后才能正式配图」。
5. 设定图缺失或不可用 → 路由到现有 IP 录入；不得 single 降级或生成正式图。

用户确认「像」后才将该样板落盘到当前 $STYLE 目录；后续正式请求重新解析为 dual。已有 IP 的正式配图不允许 single，必须 dual。 IP 文件不维护全局 ref_mode；当前风格的目录事实是唯一依据。

Step 2 · 消化内容 + 出策略

仅 $REF_MODE 已被 Step 1.5 判为 dual / style-single / none 时可进入。策略：composition-patterns.md · 视觉承诺：必载 visual-promise.md（SSOT）· 落盘：shot-config.md。

1. 加载 composition + shot-config + visual-promise
2. 按 composition Step 2 决策流程（二轴 → 创意生成法八步 → 构图库）
3. 每张 shot 填视觉承诺全家桶（visual-promise.md）+ density / 阅读顺序（composition「阅读动线语法」；scenic 强制）
4. 外参参考：按 visual-promise §B（主锚预算 + 默认特征锁不附图）；失败/超时静默降级 意象（不问用户）
5. Quick Mode：默认落盘进 Step 3；用户说「先看策略」时先展示摘要

Step 3 · 组装 Prompt + 生图

1. 加载 styles/{$STYLE}.md、prompt-template.md、对应 ip/*.md
2. 只消费 Step 1.5 已解析的 $REF_MODE：
   • dual → 设定图 + examples/{$STYLE}/ 中 1 张校准图（两张都存在才可组装）
   • style-single → $IP=none，必传 assets/none/examples/{$STYLE}/ 中按 none.md 选定的 1 张；prompt 明示只匹配画法，不复制构图、标题、物件排列或业务内容
   • none → 仍按 none 规则（无角色设定图，也无 required 风格资产）
   • 参考图未进上下文，不得声称已执行有 IP 流程
3. 按 visual-promise.md / prompt-template：追加承诺锁；外参参考 默认不附地标图（特征进 SUBJECT）；仅「外参附图=是」才附；scenic 追加阅读动线意涵（composition SSOT）
4. 填充变量槽，调用生图工具（IP_DESC 在 STYLE_DNA 之前，见 prompt-template.md）

Step 4 · QA 质检

加载 qa-checklist.md（承诺 → visual-promise；动线 → composition「阅读动线语法」）。$OUTPUT_SIZE 有值时 → 等比缩放 + 白底留白，禁止裁切。不通过 → 重试，最多 2 次。

Step 5 · 交付

outputs/{YYYYMMDD}-{slug}/
  shot-config.md      ← 配图策略 + 插入位置（与图片同时交付）
  01-{slug}.png
  02-{slug}.png       ← 多张时继续编号

版本

Public / 产品 3.0 · 三风格可选 + 自定义 IP · visual-promise SSOT