@yuhan1124/draw-prompt 0.4.0

package/references/compile.md

@@ -0,0 +1,174 @@
+# compile.md —— 「需求 → gpt-image-2 Prompt」编译方法论
+
+这是本 skill 的核心。`gpt-image` skill 的 `craft.md` 教的是「写好 prompt → 出好图」，
+本文件教的是它的**反向**：如何从使用者一句模糊需求，结合其风格档案，**稳定地编译出**
+一条结构完整、可复现的 gpt-image-2 Prompt。
+
+编译产物的目标：**结构完整、文字精确、风格可控、可稳定复现**——同一需求两次编译，
+骨架与关键约束应一致，只在创意细节上有合理变化。
+
+---
+
+## 一、Prompt 骨架（按此顺序组织，别打乱）
+
+一条好 Prompt 不是形容词堆叠，而是一组**有序的、可控的约束**。固定按这个顺序写：
+
+```
+[1 画幅/宽高比/制品类型]  ——  一句强势开场，先定结构
+[2 主体 + 场景密度]       ——  具体名词，不是空形容词
+[3 风格锚点]             ——  命名美学/媒介/制作语境，具体且有边界
+[4 材料 · 光照 · 配色]    ——  三者分开控制，各给具体词
+[5 精确文字]             ——  每个要显示的字符串用 "…" 包住
+[6 否定项]               ——  短，针对性强
+[7 输出建议]             ——  推荐 size 预设 + quality 档（给使用者，不进 prompt 正文）
+```
+
+不是每条都要七段全上——简单插画可能只需 1/2/3/6；海报/UI/信息图则七段齐全。
+
+### 1. 画幅优先于主题
+强势开场短句先定结构，避免模型把细节预算浪费在主体上：
+- `Design a 3:4 vertical poster …`
+- `Landscape 16:9 academic concept figure of …`
+- `Create a square 3×3 grid of …`
+- `A 6-panel film storyboard laid out as a 3×2 grid …`
+
+结构重要时（多面板、信息图、UI），**先说结构再说主题**。
+
+### 2. 场景密度胜过形容词
+- 弱：`a convenience store at night`
+- 强：命名 5-12 个具体名词 + 2-4 个材料/光照约束——冰柜贴纸、促销海报、湿沥青
+  反光、共享单车、手机冷光、入口地垫…
+- 删掉 `stunning / professional / beautiful / high quality` 这类空词。
+
+### 3. 风格锚点要具体且有边界
+命名美学、媒介、运动或制作语境，而不是 `modern / clean`：
+- `New Chinese visual style, light-luxury and restrained`
+- `MAPPA-style digital 2D animation`
+- `Swiss grid discipline meets friendly risograph community poster`
+- `gongbi-level architectural detail combined with loose ink atmosphere`
+- `NeurIPS camera-ready style`
+
+涉及在世工作室/IP 风格时，保持角色原创、避免直接复制（尤其用于发布）。
+
+### 4. 材料 / 光照 / 配色，三条独立控制线
+分开给词，别糊成一团：
+- 材料：`brushed steel`、`rice paper`、`condensation`、`travertine`、`linen`
+- 光照：`soft morning side light`、`rim light`、`neon reflections`、`cold blue-grey evening`
+- 配色：`muted teal/rust/bone`、`cream/warm stone/pale green`、`indigo/red-orange/cream`
+
+### 5. 精确文字——加引号，是文字类需求的生命线
+- 把**每一个**要显示的字符串包进 `"…"`；中文保持原样、不改写、不翻译。
+- 用 `/`、项目符号或布局标签分隔多块文字。
+- 密集文字明确层级：主标题 / 副标题 / 模块标签 / 图例 / 数字 / 小字。
+- 必读文字要求 `crisp, legible, large enough, no garbled characters`；
+  纯装饰文字则注明 decorative。
+- 示例：
+  > The poster must accurately display the following exact Chinese copy:
+  > `"山川茶事"` / `"冷泡系列"` / `"中杯 16 元"` / `"大杯 19 元"`
+
+### 6. 否定项——短而准
+针对常见失败模式各来一句，别堆十条：
+- `Avoid anime style, avoid high-saturation gradients, avoid garbled fake characters.`
+- `No fake sponsor logos, no unreadable microtext.`
+- 否定太多会反客为主，主导整条 prompt。
+
+### 7. 输出建议（给使用者，不写进 prompt 正文）
+编译完附一句推荐：
+- **size 预设**：`portrait`(3:4 → 1024x1536)、`landscape`(16:9 → 1536x1024)、
+  `square`(1:1 → 1024x1024)。画幅未指定时按偏好档案 `default_aspect` 推断：
+  3:4→portrait、16:9→landscape、1:1→square；其它比例直接给具体像素。
+- **quality 档**：`low`=草稿/广探；`medium`=正常探索；`high`=最终资产 / 中文文字 /
+  海报 / 图表 / UI / 论文图（**凡涉及精确文字一律 high**）。
+
+---
+
+## 二、把偏好档案注入编译（"懂你"的落点）
+
+编译**前**先 `profile show`，把档案里的字段当默认底色：
+
+| 档案字段 | 注入方式 |
+|---|---|
+| `favored_styles` | 需求没指定风格时，从这里选最贴近的锚点 |
+| `default_aspect` | 需求没指定画幅时，用它 |
+| `default_quality` | 输出建议的 quality 默认值 |
+| `avoided_elements` | 直接进 prompt 的否定项 |
+| `text_language` | 文字渲染默认语种（zh→中文字面量 + `Simplified Chinese`） |
+| 自由笔记 | 软约束：留白、配色克制、镜头偏好等，融进对应骨架段 |
+
+**本次需求显式覆盖 > 档案默认**。注入要自然，别把档案字段生硬复述给使用者。
+
+---
+
+## 三、两层范例：先 baseline，再叠个人 delta
+
+**第 0 层 · 自带金标准库（baseline，人人共享）**：先读 `references/gallery.md`，按品类
+路由索引找最近 1-2 条对标改编。这层与用户无关，保证产出**开箱即好**——把方括号 `[…]`
+占位换成本次需求的具体内容，骨架与法则照搬。
+
+**第 2 层 · 个人 few-shot（你的 delta）**：再 `samples search "<tags/关键词>"` 取**采纳**
+样本，从中借用：
+- 有效的结构骨架与段落顺序；
+- 被验证可读的文字排布措辞；
+- 上次 reject 的原因 → 这次主动规避（reject 样本是负例，同样有价值）。
+
+顺序很重要：**baseline 先把质量托起来，个人层只调风格 delta，不从零开始。**
+不要照抄整条；借结构与约束，换创意内容。
+
+---
+
+## 四、分类小模式（按资产类型微调骨架）
+
+- **海报/排版**：制品类型 + 画幅 → 精确文字层级（标题最大、CTA、价格、小字）→
+  促销三瞥测试（轮廓→信息→纹理）→ 否定假 logo / 微缩乱码。中文海报标 `Simplified/
+  Traditional Chinese`，必 high。
+- **UI/UX**：读起来像产品规格——虚构产品名（避免真品牌泄露）→ 设备画布
+  (`1290x2796 smartphone screen`) → 调色板与组件系统 → 顶栏含精确 in-image 文案 →
+  卡片/图表/导航/数据行带可信数值 → `crisp typography, precise icon alignment,
+  production-quality mockup`。
+- **信息图/科普板**：命名制品（`museum catalog-style infographic`）→ 固定布局区域
+  （顶标题/左分解/右摘要/底图例）→ 注释行为（引导线、编号标签）→ 风格边界 → 精确标签。
+- **研究/数据图**：方向+会场风格 → 结构基元（列/区/面板/节点/箭头/丝带）→ 有向关系
+  语义 → 精确标签 → `large readable labels, white background, uncluttered,
+  publication-grade`。
+- **产品/食品**：复杂高级渲染可用 **JSON 配置式 prompt**（见下）。
+- **多面板**：精确说网格数（`3×3`、`16-panel`）→ 每格分配角色/节拍 → 共享美术指导
+  （配色、服装、光照、角色身份）→ 故事板加镜头语言（WIDE/OTS/CU、机位、时长）。
+- **写实摄影**：选一个主导捕获语境——`RAW, unprocessed, full iPhone camera quality`
+  降 AI 味、`shot from the crowd at a distance` 给真实事件感、`28mm lens feel` 给建筑
+  真实感。别叠太多机位规格，会打架。
+- **编辑/改图**（有参考图、交给下游 edit 端点时）：骨架与文生图不同——
+  ① 先一句命名**目标变化**（"换成冬夜大雪"）；② 紧接着明确**保留的不变量**：
+  身份/布局/位置/文字/可读性（"棋局位置仍清晰可读"）；③ 改海报/模板时除非要求翻译，
+  否则保留原文字；④ 多参考逐个标角色与交互方式：`Image 1: 产品照`、`Image 2: 风格参考`、
+  `Image 3: logo`，并说清它们如何结合；⑤ 局部改动用蒙版（mask）。
+  完整规则见 gpt-image `craft.md` 原则 13（Edit endpoint 不变量 / 多参考）。
+
+---
+
+## 五、JSON 配置式 Prompt（高级渲染模式）
+
+产品/食品/复杂多系统场景，用结构化 JSON 把"视觉子系统"显式拆开，模型遵循度更高：
+
+```
+/* PRODUCT_RENDER_CONFIG: Short Name  VERSION: 1.0.0
+   AESTHETIC: Premium Commercial Photography */
+{
+  "GLOBAL_SETTINGS": { "aspect": "3:4", "render_flags": ["8K_UHD","sharp_foreground","no_CGI_tell"] },
+  "ENVIRONMENT": { "...": "具体视觉约束，不是模糊赞美" },
+  "CORE_ASSETS": { "...": "材质/几何/标签" },
+  "LIGHTING": { "...": "..." },
+  "OUTPUT": { "...": "editorial_finish" }
+}
+```
+规则：key 描述视觉子系统而非实现细节；value 是具体约束；数组放可见元素，嵌套对象放
+材质/光照/输出目标；JSON 不必机器合法（注释有帮助即可），但保持整洁。
+
+---
+
+## 六、稳定复现的纪律
+
+- **骨架固定**：同类需求总按上面七段顺序，使产物可预期、可对比、可迭代。
+- **文字必引号**：任何要显示的字符再短也包 `"…"`。
+- **风格有边界**：锚点具体到媒介/制作语境，避免 `nice/modern` 这类无法复现的词。
+- **质量看用途**：精确文字 / 海报 / UI / 图表一律 high。
+- **改进可追溯**：每次迭代写清"这版相对上版改了什么、为什么"，进 samples 的 reason。

package/references/conversion-skill-plan.md

@@ -0,0 +1,370 @@
+# conversion-skill-plan.md —— 生图转化 Skill 完整方案
+
+## 目标
+
+`draw-prompt` 的第一目标是做一个**生图转化 Skill**：
+
+```
+自然语言画图需求 -> 细分模板 -> 结构化 Prompt Spec -> 高质量生图 Prompt -> 可交给下游的 handoff 指令
+```
+
+它不直接出图，不消耗下游算力，不要求 `OPENAI_API_KEY`。偏好档案、样本库和评分回路只服务于
+“转化质量更稳定、更贴近使用者风格”，不能替代主目标。
+
+## 非目标
+
+- 不实现图像生成 API。
+- 不主动执行 `codex exec`、`/codex-image:generate` 或任何下游出图命令。
+- 不把一次性需求自动固化为长期审美默认值。
+- 不把 prompt 收藏、样本管理、评分报表作为第一入口。
+
+## 转化链路
+
+1. **Intake 需求理解**：识别资产类型、主体、画幅、必显文字、风格线索、用途。
+2. **细分模板路由**：把大类继续落到 `poster_zh_promo`、`ui_mobile_home`、
+   `diagram_rag` 等稳定模板，减少同类需求的随机漂移。
+3. **Spec 结构化**：把需求转成稳定字段：`asset_type`、`template_id`、`aspect`、
+   `required_text`、`layout`、`text_hierarchy`、`must_include`、`must_avoid`、
+   `acceptance_criteria`、`style_anchors`、`materials`、`lighting`、`palette`、`size`、`quality`。
+4. **Prompt 渲染**：按资产类型模板生成模型友好的 prompt，固定遵守画幅优先、文字引号、
+   材料/光照/配色分离、短否定项等规则。
+5. **Strict text（按需）**：文字要求严格时输出 visual prompt + `text_overlay_spec`，
+   让生图阶段只负责背景/版式，文字由后处理精确叠加。
+6. **真实场景编排**：长输入先拆成多张图的 `visual_plan`；系列图共享 style/palette；
+   改图明确 reference/preserve/change；品牌和角色输出可复用一致性档案；数据图保留 schema。
+7. **安全改写**：涉及真实 IP、品牌、工作室/艺术家风格时，自动改写为原创视觉语言，并加入
+   no real brand logos / no existing IP resemblance 等避让项。
+8. **Lint 自检**：检查 prompt 是否缺画幅、必显文字是否未加引号、文字类是否未用 high、
+   是否缺否定项、是否有真实品牌风险。
+9. **Handoff 交付**：输出 raw prompt、`/codex-image:generate ...` 或 `codex exec ...`。
+10. **Benchmark 基准**：模板变动后跑 golden cases，多次转化检查 digest 稳定与 lint 通过。
+11. **Feedback / Revise 回流**：出图失败后记录结构化失败分类，并用 `revise` 生成修订版。
+
+## CLI 契约
+
+### `convert`
+
+主入口。把自然语言需求直接转成 Prompt，可选输出 handoff，可选记录 pending 样本。
+
+```bash
+python3 scripts/prompt_cli.py convert \
+  "茶饮新品海报，国风一点，写冷泡系列，价格 16/19 元" \
+  --strict-text \
+  --out poster.png \
+  --record-pending
+```
+
+输出包含：
+
+- `Prompt`：可直接喂给生图模型。
+- `text_overlay_spec`：仅 `--strict-text` 时输出，用于精确文字后处理。
+- `推荐 size / quality / asset_type`。
+- `acceptance_criteria`：该图的验收标准。
+- `Lint`：转化质量检查。
+- `Handoff`：默认 `/codex-image:generate` 指令。
+- `sample_id`：仅在 `--record-pending` 时输出。
+
+### `lint`
+
+检查任意 Prompt 是否满足生图转化硬约束。
+
+```bash
+python3 scripts/prompt_cli.py lint \
+  --prompt "Design a 3:4 vertical poster with exact text \"冷泡系列\". Avoid garbled text." \
+  --asset-type poster \
+  --quality high \
+  --text 冷泡系列
+```
+
+有 `error` 时返回非零退出码；只有 warning 或无问题时返回 0。
+
+### `benchmark`
+
+批量跑 golden cases，检查同一 case 多次转化是否 deterministic，以及是否出现 lint error。
+
+```bash
+python3 scripts/prompt_cli.py benchmark references/golden-cases.jsonl --runs 3
+```
+
+这一步不出图，只验证转化层稳定性。它输出每个 case 的 `template_id`、`prompt_digest`、
+lint 结果和 acceptance criteria。
+
+### `revise`
+
+按结构化失败分类修订 Prompt。
+
+```bash
+python3 scripts/prompt_cli.py revise --sample-id last --reason text_error --record-pending
+```
+
+支持分类：
+
+| 分类 | 用途 |
+|---|---|
+| `text_error` | 文字错误、乱码、漏字，自动切换 strict text |
+| `layout_error` | 布局区域错位或重叠 |
+| `missing_subject` | 主体缺失 |
+| `wrong_style` | 风格不匹配 |
+| `too_cluttered` | 画面过满 |
+| `bad_composition` | 构图弱 |
+| `brand_risk` | 真实品牌、Logo、IP 风险 |
+| `low_readability` | 对比度低、标签不可读 |
+
+### `handoff --record-pending`
+
+当 agent 手写 Prompt 时，也能把 handoff 变成可追踪样本。
+
+```bash
+python3 scripts/prompt_cli.py handoff \
+  --request "茶饮新品海报" \
+  --prompt "..." \
+  --out poster.png \
+  --size portrait \
+  --quality high \
+  --tags poster,tea \
+  --record-pending
+```
+
+### `compose`
+
+覆盖真实高频场景：用户给一段很长的输入，让 agent 先整理，再画一组对应图片。
+
+```bash
+python3 scripts/prompt_cli.py compose \
+  "1. 产品目标... 2. 技术架构... 3. 使用步骤..." \
+  --max-images 6 \
+  --strict-text \
+  --json
+```
+
+输出 `visual_plan[]`，每项包含：`brief`、`asset_type`、`template_id`、`spec`、`prompt`、
+`handoff`、`lint`、`acceptance_criteria`。拆分策略是确定性的：优先按标题/编号/列表拆；
+不足时按句群切分。每个片段再路由到 poster / diagram / infographic / ui / product /
+character / illustration。
+
+### `series`
+
+覆盖一组风格统一的图，例如活动 KV、社媒九宫格、产品多卖点图。
+
+```bash
+python3 scripts/prompt_cli.py series \
+  --brief "春季茶饮主视觉" \
+  --brief "同一风格社媒方图" \
+  --style "clean premium beverage campaign" \
+  --palette "jade green,warm white"
+```
+
+所有 brief 共享 `shared_style` 和 palette，但每张图仍单独生成 spec/prompt/lint。
+
+### `edit`
+
+覆盖参考图/改图：用户给图后希望保留主体、只改局部。
+
+```bash
+python3 scripts/prompt_cli.py edit \
+  --goal "把杯子背景换成夏季冷泡茶吧台" \
+  --reference product:cup.png \
+  --preserve "cup silhouette" \
+  --change "background only"
+```
+
+输出 `edit_spec`：`references`、`preserve`、`change`、`required_text`、`aspect`、`quality`。
+Prompt 明确“保留什么、只改什么”，减少身份和构图漂移。
+
+### `brand`
+
+覆盖品牌一致性：品牌调性、配色、禁用项可形成可复用 prompt block。
+
+```bash
+python3 scripts/prompt_cli.py brand \
+  --name "山川茶事" \
+  --industry "茶饮" \
+  --palette "moss green,ivory" \
+  --request "新品冷泡茶品牌主视觉"
+```
+
+输出 `brand_profile` 和 `brand_prompt_block`；如带 `--request`，会直接编译一张品牌资产。
+规则里固定要求原创标识、禁用真实商标和 stock clip-art。
+
+### `character`
+
+覆盖角色/IP 一致性：先生成角色 bible，再生成参考表和多场景 prompt。
+
+```bash
+python3 scripts/prompt_cli.py character \
+  --name Mira \
+  --description "short silver hair, amber eyes, explorer coat" \
+  --scene "standing beside a glowing archive machine"
+```
+
+输出 `character_bible`、`reference_sheet`、`scene_prompts[]`。每个场景 prompt 都先复述同一套
+身份锚点，且明确不相似已有 IP。
+
+### `data-viz`
+
+覆盖报告图、图表、数据可视化。
+
+```bash
+python3 scripts/prompt_cli.py data-viz \
+  --file metrics.csv \
+  --request "展示转化率趋势" \
+  --title "转化率趋势" \
+  --strict-text
+```
+
+支持 CSV / TSV / JSON。输出 `chart_data_spec`，包含 columns、row_count、rows_preview、
+chart_type；strict text 时输出 `chart_text_overlay`，数字和标签由确定性叠加层处理。
+
+### `rewrite`
+
+覆盖“用户给了很烂的 prompt”：把空泛描述改成结构化、可 lint 的高质量 prompt。
+
+```bash
+python3 scripts/prompt_cli.py rewrite "做一个迪士尼风格的角色海报，好看高级" --asset-type poster
+```
+
+会把真实 IP/品牌/风格引用改写成原创视觉语言，并在 `spec.safety_rewrite` 里记录改写原因。
+
+### `adapt`
+
+覆盖多渠道投放尺寸：同一个主体和文案，输出多套专属布局 prompt。
+
+```bash
+python3 scripts/prompt_cli.py adapt \
+  "茶饮新品海报，写冷泡系列" \
+  --aspects 1:1,3:4,16:9,9:16 \
+  --text "冷泡系列"
+```
+
+每个画幅都有单独 layout：横版、竖版、方图、移动长图分别设计，不做简单裁切。
+
+### `overlay`
+
+彻底解决复杂中文、价格、品牌名、图表标签不稳定的问题：模型只生成视觉背景，最终文字由
+确定性后处理写入。
+
+```bash
+python3 scripts/prompt_cli.py convert \
+  "茶饮新品海报，写冷泡系列，价格 16/19 元" \
+  --strict-text --text "冷泡系列" --text "16/19 元" --json > spec.json
+
+python3 scripts/prompt_cli.py overlay \
+  --image raw.png \
+  --spec spec.json \
+  --out final.png
+```
+
+`text_overlay_spec` 现在包含归一化 `box`、`align`、`font_weight` 等信息。`overlay` 会优先使用
+系统中文字体，自动缩放字号、换行、加半透明底，确保文字可读。
+
+### `visual-check`
+
+单图质量门。检查尺寸、画幅、亮度、对比度和边缘细节，避免空白图、过曝图、低清图进入样本库。
+
+```bash
+python3 scripts/prompt_cli.py visual-check --image final.png --spec spec.json
+```
+
+### `edit-check`
+
+参考图/改图质量门。它不替代人工视觉判断，但能用确定性指标拦截两类常见失败：
+主体漂移、没有有效变化。
+
+```bash
+python3 scripts/prompt_cli.py edit-check --reference ref.png --output edited.png
+```
+
+输出 `center_subject_similarity` 和 `full_image_change`。前者过低说明主体可能没保住，后者过低
+说明目标修改可能没生效。
+
+### `visual-regress`
+
+多场景回归入口。默认先检查 prompt 编译、lint 和 digest；case 若带 `image` / `output`，会进一步
+做成品图质量检查；case 若带 `reference` + `output` 且无 request，则走 `edit-check`。
+
+```bash
+python3 scripts/prompt_cli.py visual-regress references/visual-cases.jsonl
+python3 scripts/prompt_cli.py visual-regress references/visual-cases.jsonl --require-images
+```
+
+`references/visual-cases.jsonl` 当前覆盖：文字海报、长输入架构图、系列产品图、品牌 KV、角色设定、
+数据图、多尺寸适配和风险改写。
+
+## 资产类型路由
+
+当前支持这些主类型：
+
+| 类型 | 场景 | 默认 |
+|---|---|---|
+| `poster` | 海报、主视觉、促销图 | 3:4 / portrait / high |
+| `ui` | App、Web、Dashboard、产品界面 | 9:16 / portrait / high |
+| `infographic` | 科普、图解、流程说明 | 3:4 / portrait / high |
+| `diagram` | 架构图、论文图、系统图 | 16:9 / landscape / high |
+| `product` | 产品、食品、电商渲染 | 3:4 / portrait / high |
+| `photography` | 写实摄影、纪实照片 | 16:9 / landscape / high |
+| `character` | 角色设计、立绘、三视图 | 16:9 / landscape / high |
+| `illustration` | 插画、绘本、风格化图像 | 1:1 / square / medium |
+| `logo` | Logo、品牌系统板 | 1:1 / square / high |
+
+细分模板示例：
+
+| 模板 | 大类 | 稳定点 |
+|---|---|---|
+| `poster_zh_promo` | poster | 标题区、产品区、价格/优惠区、静默页脚 |
+| `poster_brand_kv` | poster | 单一 hero visual、品牌信息区、大留白 |
+| `ui_mobile_home` | ui | 手机状态栏、头部、内容卡片、主按钮、底部导航 |
+| `ui_dashboard` | ui | 侧边栏、顶部栏、KPI、图表、表格 |
+| `diagram_rag` | diagram | User -> Retriever -> Vector DB -> LLM -> Answer |
+| `diagram_system` | diagram | 分层盒子、有向箭头、图例 |
+
+## 质量门
+
+转化质量必须至少满足：
+
+- 画幅/制品类型先行。
+- 必显文字全部用英文双引号或中文引号包住。
+- 中文文字保持原样，不翻译、不改写。
+- 海报、UI、信息图、图表、Logo、任何精确文字需求都默认 `high`。
+- prompt 里必须有针对常见失败模式的否定项。
+- 涉及 logo / brand 时必须规避真实品牌和 stock clip-art。
+- 输出 handoff 时，`codex-image` 不加外层引号，避免破坏 prompt 内部精确文字引号。
+- strict text 模式下，prompt 不要求模型直接写必显文字；必须输出 `text_overlay_spec`。
+- 精确文字最终必须通过 `overlay` 确定性写入，再用 `visual-check` 验收。
+- 参考图/改图输出必须通过 `edit-check`，确认主体保留且修改生效。
+- 多场景策略变动必须跑 `visual-regress references/visual-cases.jsonl`。
+- 每个 spec 必须带 `acceptance_criteria`，用于人工或视觉模型验收。
+
+## 偏好学习的位置
+
+偏好学习是辅助层：
+
+- `profile` 提供默认风格、画幅、排斥项。
+- `samples` 提供历史正负样本。
+- `judge` 记录成品图质量。
+- `revise` 把失败分类转成下一版 prompt 修复策略。
+
+长期偏好只应来自用户明确表达或多次稳定复现；agent 推断只作为 `inferred` 弱信号。
+
+## 验收标准
+
+实现完成的证据必须包括：
+
+- `convert` 能从一句中文画图需求生成 spec、prompt、handoff。
+- `compose` 能把长输入拆成多张图，并给每张图独立 prompt/handoff/lint。
+- `series` 能输出共享风格的一组 prompt。
+- `edit` 能表达 reference / preserve / change 契约。
+- `brand` / `character` 能输出一致性档案并编译示例 prompt。
+- `data-viz` 能读取 CSV/TSV/JSON schema 并输出图表 prompt。
+- `rewrite` 能把真实 IP/品牌风险改写成原创视觉语言。
+- `adapt` 能为多个画幅输出不同布局 prompt。
+- `overlay` 能把 `text_overlay_spec` 真实渲染到成品图。
+- `visual-check` 能对成品图做基础质量门。
+- `edit-check` 能对参考图编辑做主体保留/有效变化检查。
+- `visual-regress references/visual-cases.jsonl` 能稳定通过。
+- `convert --strict-text` 能输出 visual prompt + `text_overlay_spec`。
+- `lint` 能拦截未加引号文字、缺画幅、文字类非 high 等硬错误。
+- `handoff --record-pending` 能写入 pending 样本并返回 sample id。
+- `benchmark references/golden-cases.jsonl --runs 3` 稳定通过。
+- `revise --reason text_error` 能把文字失败样本切到 strict text 修订版。
+- README、SKILL、handoff 文档和脚本真实行为一致。
+- 自动化测试覆盖上述契约，并在隔离 `DRAW_PROMPT_HOME` 下通过。