gimi-xiaomi gimi-illustration · 配图 Skill
Public 3.0 = 产品 v3.0（多风格：怪诞手绘 / 暖调绘本 / 产品方案 + 自定义 IP）
换窗口：有
docs/时先读docs/INDEX.md→docs/roadmap.md；执行以本文件 +references/ip/_template.md为准
⚠ 路由分流（先读 · 防 ImageGen 抢跑）
触发含 自定义 IP / 录入 IP / 上传形象 / 新建 IP（可附图）时：
- 立刻加载
references/ip/_template.md，走 Step 0；不要先当「配图 / 海报」生图 - 本回合禁止调用任何生图工具（
image_gen/GenerateImage/ ImageGen 等），直到用户已回答「按这个形象方案录入吗？」- 半身/全身相同：首轮只出形象方案 + 收尾问；零例外
- 确认后：半身才允许 0.2b 全身设定稿；再 0.4 校准
- 禁止把录入理解成「生成一张 IP 主题海报 / 原创插画海报」
- 细则与话术以
_template为准；本段与之冲突时，以本段路由为准（先拦抢跑）
触发仅为 配图 / illustration 等、且非录入 IP → 走下方 Quick Mode / Step 1–5。
输入文章内容，生成配图。默认风格「怪诞手绘」（quirky-sketch），可切换已录入风格（如「暖调绘本」）；IP 为 gimi / none / 自定义实例，默认 16:9。
触发词
配图：配图 / 给文章配图 / 帮我配图 / illustration
自定义 IP：自定义 IP / 录入 IP / 上传形象 / 新建 IP
参考文件（按需加载）
| 文件 | 何时加载 |
|---|---|
docs/INDEX.md |
换窗口文档导航（先读） |
docs/roadmap.md |
换窗口工作台 / 要改规则时 |
docs/spec.md |
产品规划（防跑偏）；非执行协议 |
references/styles/{$STYLE}.md |
生图 / 校准 / 风格 QA 时 |
references/styles/_template.md |
批量录入新风格时（非配图热路径） |
references/composition-patterns.md |
出策略时（非 Step 0） |
references/visual-promise.md |
Step 2 判视觉承诺 / 结构·外参·域物件（SSOT；细则不抄进本文件） |
references/shot-config.md |
出策略时（非 Step 0） |
references/prompt-template.md |
组装 prompt 时 |
references/qa-checklist.md |
质检时 |
references/ip/_template.md |
自定义 IP / Step 0（优先于生图） |
references/ip/gimi/ip.md |
$IP = gimi |
references/ip/none.md |
$IP = none |
references/ip/{id}/ip.md |
$IP 为已存在的自定义 id |
生图能力
调用当前 AI 软件内置的生图工具（如 Codex @Image Gen、Cursor GenerateImage 等）。Skill 负责策略、prompt 组装、参考图附件、QA；生图由平台工具执行。接口语义：文本 prompt + 可选图片附件。
Step 0 录入中： 遵守文首「路由分流」；未满足允许条件前不得调用生图工具。
平台适配优先级：
- 支持显式图片附件的平台：把参考图作为 image reference 附件传入。
- Codex
image_gen：已有 IP 的正式配图一律传「设定图 + 当前(IP, STYLE)校准图」；先跑 Step 1.5，缺任一张不得生正式图；再image_gen - 不支持图片输入且无法把图片放入上下文时，暂停说明原因；已有 IP 不得降级为仅文字锚点的正式配图。
核心变量
| 变量 | 默认值 | 说明 |
|---|---|---|
$STYLE |
quirky-sketch |
默认怪诞手绘；可按主人语言切换为已录入风格（见 Step 1） |
$RATIO |
16:9 |
宽高比；用户可指定任意比例 |
$IP |
gimi |
gimi / none / 其他：若存在 references/ip/{id}/（非 _template）则加载该实例 |
$REF_MODE |
解析得出 | dual / style-single / none；已有 IP 缺当前风格校准时为 lazy 门禁，不是可交付参考模式 |
$TITLE |
无 | 用户要求时顶部手写标题 |
$COUNT |
自动推断 | 配图张数 |
$OUTPUT_SIZE |
无 | 可选；仅用户明确要求具体像素时记录 |
推荐像素（非强制）： 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 完成前）——与文首路由分流一致：
- 入口（半身/全身相同）：首轮只出形象方案 +「按这个形象方案录入吗？」；一律禁生图；禁海报式成稿
- 禁止配图抢跑：不得进 Step 1–5；不得写
shot-config.md - 出图后必须提问：同轮追加收尾问；图 ≠ 闭合（仅 0.2 确认之后才允许生图）
- 半身：确认后 0.2b 须头到脚；落盘
reference-character.png一律 full - 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）：
- 扫描
references/styles/*.md（排除_template.md）的display_name/aliases - 明确命中 → 锁定对应
id - 软命中 → 一句确认（例：「你是说「暖调绘本」那种纸纹暖色吗？」）
- 未命中或「换个风格」→ 人情味菜单：每项
display_name+tagline（默认可标「常用」） - 未提风格 →
quirky-sketch；本会话首次配图追加一句轻提示（不打断）：
「这次先用怪诞手绘。若想换成暖调绘本（纸纹暖色、旅行手帐感），直接说就行。」 - 用户描述未录入风格 → 不现场发明；说明目前仅已录入风格，问用默认或以后再录
口语优先；$STYLE=… 仅进阶。对用户称 display_name，不说路径。
Step 1.5 · 当前参考解析（IP 与无 IP）
在进入 Step 2、写 shot-config.md 或生成正式图之前，对当前 (IP, STYLE) 只判一次：
$IP=none且当前风格「无 IP 校准策略」为required style-single→ 必须按references/ip/none.md选择assets/none/examples/{$STYLE}/中 1 张，记为$REF_MODE=style-single；缺目录 / 缺选图是发布包资产问题，停止并修复，不向用户索图、不降级为纯文本。$IP=none且当前风格没有 required 策略 →$REF_MODE=none，保持既有 none 行为；若该风格声明 optional 且有资产，可按none.md选 1 张作质量收敛。- 已有全身设定图且
assets/ip/{$IP}/examples/{$STYLE}/至少有 1 张可用校准图 →$REF_MODE=dual，可进 Step 2。 - 已有全身设定图但当前风格校准目录为空 / 缺文件 →
$REF_MODE=lazy；只按当前风格 0.4 生成样板，QA 后问「像吗？」；禁止写shot-config.md、生成正式图、或附其他风格校准图充当双参考。用户催图也不降级；应说明「这个风格的样板还没定，确认样板后才能正式配图」。 - 设定图缺失或不可用 → 路由到现有 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。
- 加载 composition + shot-config + visual-promise
- 按 composition Step 2 决策流程（二轴 → 创意生成法八步 → 构图库）
- 每张 shot 填视觉承诺全家桶（
visual-promise.md）+ density / 阅读顺序（composition「阅读动线语法」；scenic强制） 外参参考：按 visual-promise §B（主锚预算 + 默认特征锁不附图）；失败/超时静默降级意象（不问用户）- Quick Mode：默认落盘进 Step 3；用户说「先看策略」时先展示摘要
Step 3 · 组装 Prompt + 生图
- 加载
styles/{$STYLE}.md、prompt-template.md、对应ip/*.md - 只消费 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 流程
- 按
visual-promise.md/prompt-template：追加承诺锁；外参参考默认不附地标图（特征进 SUBJECT）；仅「外参附图=是」才附；scenic追加阅读动线意涵（composition SSOT） - 填充变量槽，调用生图工具（
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