docs(design-assets): 明确 Image2 与透明素材流程

Author: sincerely90

plugins/aisee-plugin/skills/aisee-design-assets/SKILL.md

@@ -5,7 +5,7 @@ description: 通用视觉参考图、设计证据与生成型素材工作流。
 
 # aisee:design-assets
 
-把用户描述、参考图和已有视觉规范转成项目本地可复用的参考图、StyleSpec 草稿、素材和下游视觉 brief。它是轻量工作流 skill，不是完整工作台、需求工具、长期设计规范事实源、Figma 写入器或前端实现器。
+把用户描述、参考图和已有视觉规范转成可执行的图片生成提示、项目本地参考图、StyleSpec 草稿、素材清单和下游视觉 brief。它是轻量工作流 skill，重点是为参考图和素材生成补齐 prompt 约束，不是完整工作台、需求工具、长期设计规范事实源、Figma 写入器或前端实现器。
 
 生成 design-assets 索引、brief 或相关 planning doc 时，frontmatter 字段合同统一遵循 `plugins/aisee-plugin/references/planning-doc-frontmatter.md`；它只服务索引和追踪，不替代 OpenSpec 事实源。
 
@@ -51,52 +51,6 @@ description: 通用视觉参考图、设计证据与生成型素材工作流。
 - `tasks.md` 只记录资产接入、切图落地、截图比对或人工验收任务。
 - 不把完整 StyleSpec、图片生成过程、prompt 库内容或资产索引正文复制进 change artifacts。
 
-## 内置提示词库
-
-内置 GPT Image 2 中文原始提示词库位于：
-
-```text
-aisee-design-assets/prompt-library/gpt-image-2/
-├── catalogs/
-│   ├── prompts.jsonl
-│   ├── prompts.csv
-│   ├── prompts.xlsx
-│   ├── excluded.jsonl
-│   └── summary.json
-├── raw-index/
-└── sources.md
-```
-
-使用约束：
-
-- 只保留原始语言为中文或 prompt 正文本身为中文的条目。
-- 不把英文、日文、韩文等非中文 prompt 翻译后入库；正文含日文假名或韩文时必须排除。
-- EvoLinkAI 作为默认种子来源，从 canonical cases 中按中文正文筛选。
-- YouMind 作为补充来源，默认通过 sitemap 发现 detail 页，并只保留 detail 页原始 `language/originalLanguage == zh` 的 `content`。
-- `translatedContent` 不能作为入库正文。
-- `catalogs/prompts.xlsx` 面向人工查看，只保留来源、分类、标题、详细提示词、来源链接、许可证、风险备注等精简字段。
-- 读取提示词时使用脚本，不手工批量打开整库。日常按意图优先用 `search` 读取 JSONL；需要核对 Excel 展示内容时用 `read-excel`：
-
-```bash
-python3 aisee-design-assets/scripts/gpt_image2_prompt_library.py search --intent ui --limit 5
-python3 aisee-design-assets/scripts/gpt_image2_prompt_library.py search --query "电商 主图" --no-risk --limit 5
-python3 aisee-design-assets/scripts/gpt_image2_prompt_library.py read-excel --query "UI 设计系统" --limit 5
-python3 aisee-design-assets/scripts/gpt_image2_prompt_library.py categories
-python3 aisee-design-assets/scripts/gpt_image2_prompt_library.py discover-youmind-sitemap --limit 20
-```
-
-支持的 `--intent`：`asset`、`character`、`ecommerce`、`infographic`、`poster`、`social`、`style`、`ui`。
-
-需要刷新来源时运行：
-
-```bash
-python3 aisee-design-assets/scripts/gpt_image2_prompt_library.py build
-```
-
-刷新会访问 GitHub 公开来源和 YouMind 公开 detail 页，并更新 skill 内的 `prompt-library/gpt-image-2/catalogs/` 与 `raw-index/`。如果 YouMind 返回 429，降低 `--youmind-workers` 或稍后再试；脚本会优先使用已缓存的 sitemap URL。
-
-需要追求 YouMind CMS 真正全量时，不要依赖 README 或 sitemap。若有授权的 CMS API 配置，则优先使用 CMS API。无论哪种方式，都只保留原始中文 prompt，不使用 `translatedContent` 作为入库正文。
-
 ## Phase 0 — 读取上下文
 
 先定位目标项目目录：用户给了项目路径就用该路径，否则使用当前工作目录。
@@ -120,27 +74,29 @@ rg --files | rg '(style.*spec.*\.(md|json)|design.*asset.*index.*\.md|asset.*man
 
 - 生成参考图、保结构重绘、从规范生成新图：读 `references/workflow.md`
 - 视觉质量优先、用户上传参考图/截图、图片转视觉 brief 或 image-first 工作流：读 `references/image-first.md`
-- 图片生成、图生图视觉变体、透明生成型素材、CLI fallback：读 `references/image-generation.md`
+- Image2 图片生成、图生图视觉变体、透明生成型素材、CLI fallback：读 `references/image-generation.md`
 - 提取或生成 StyleSpec 草稿：读 `references/style-spec.md`
 - 规划、生成或复核素材清单：读 `references/asset-manifest.md`
-- 生成前提示词优化：读 `references/prompt-optimization.md`
+- 生成前提示词优化：必须读 `references/prompt-optimization.md`
+- 需要借鉴中文图片生成 prompt 写法：读 `references/prompt-library.md`
 - 不同端尺寸、清晰度、安全区、图生图保留项：读 `references/output-specs.md`
 - 图标库、组件库、通用图标替换策略：读 `references/icon-library.md`
 - 生成 Figma / 开发视觉 brief：读 `references/downstream-briefs.md`
 - 建立目录和索引：读 `references/output-layout.md`
 
-当用户要生成参考图、视觉方向、海报、电商图、社媒图、信息图、角色、插画、图标或素材时，先用 `scripts/gpt_image2_prompt_library.py search` 按 `--intent` 或 `--query` 读取 3-5 条相关中文原始提示词作为参考；只借鉴结构、描述密度和视觉约束写法，不直接照抄，不引入无关品牌、人物、Logo、文案或业务字段。需要确认 Excel 里的人工表格内容时，再用 `read-excel`。
+当用户要生成参考图、视觉方向、海报、电商图、社媒图、信息图、角色、插画、图标或素材时，先做 prompt 完善；需要参考写法时，用 `scripts/gpt_image2_prompt_library.py search` 读取 3-5 条相关中文原始提示词，只借鉴结构和视觉约束写法。
 
 常见闭环：
 
 1. 只有描述且要视觉方向：按 image-first 判断是否生成参考图。
 2. 有参考图/截图且要沉淀风格线索：先分析参考图，再生成 StyleSpec 草稿；需要长期规范时交给 `aisee:design-spec`。
 3. 有 `aisee:design-spec` 或 StyleSpec 且要新页面视觉：基于规范生成新参考图。
 4. 有长页面、Landing、多状态或多端视觉任务：按页面 / section / 关键状态分图生成或分析，不压成单张超长图。
-5. 有参考图/规范且要素材：生成素材清单；生成型背景、插画、banner、装饰层和插画型小图形由本 skill 生成，并以参考图一致性为硬约束；基于已有图片提取的对象素材转交 `aisee:image-object`。
+5. 有参考图/规范且要素材：生成素材清单；生成型背景、插画、banner、装饰层和插画型小图形由本 skill 使用 Image2 生成，并以参考图一致性为硬约束；基于已有图片提取的对象素材转交 `aisee:image-object`。
 6. 有已有图片且要修改：只有“保结构重绘 / 视觉变体 / 参考图再生成”留在本 skill；涉及对象、mask、局部修补、去背景、抠图、透明切图或图层包时转交 `aisee:image-object`。
 7. 需要进入 Figma MCP 或前端开发：生成对应 brief；前端只拿 `dev-visual-brief` 做视觉输入，不让本 skill 写代码。
 8. 要从已有扁平图片中分离对象、生成 mask、交互式框选/点选、导出透明对象、移除对象并补背景或生成图层包：交给 `aisee:image-object`；本 skill 只负责把产物登记到设计资产索引。
+9. 要透明素材：从零生成的独立透明素材留在本 skill，先用 Image2 生成绿幕/纯色背景或按 CLI 原生透明流程处理；从已有图片提取透明对象、修边、抠图、去背景或 mask 的流程交给 `aisee:image-object`。
 
 ## Phase 2 — 输入门禁
 
@@ -160,7 +116,7 @@ rg --files | rg '(style.*spec.*\.(md|json)|design.*asset.*index.*\.md|asset.*man
 
 ## Phase 3 — 执行
 
-执行前做轻量提示词优化：整理结构、补齐必要约束，不添加未确认的业务需求、Logo、文案、人物、字段或数据。
+执行前必须做轻量提示词优化：整理结构，补齐平台、用途、尺寸、参考依据、主体、构图、风格、不变项、允许变化和避免项；不添加未确认的业务需求、Logo、文案、人物、字段或数据。
 
 CHECKPOINT: 执行图片生成、图生图视觉变体、外部 API 调用、刷新远程提示词来源、覆盖既有图片/索引或写入长期资产前，必须确认目标、输入来源、输出目录、是否覆盖、是否使用外部 API、成本/配额风险和敏感信息处理。未确认时只输出方案、提示词和待确认项，不声称已生成。
 
@@ -171,15 +127,12 @@ CHECKPOINT: 执行图片生成、图生图视觉变体、外部 API 调用、刷
 - `allowed_variation`：允许变化的主体、尺寸、裁切、状态、背景或透明导出范围。
 - `consistency_check`：生成或登记后按 `passed` / `warnings` / `failed` 记录是否保持一致，以及需要人工复核的点。
 
-图像生成路径按 `references/image-generation.md` 决策。核心原则：
+图像生成路径按 `references/image-generation.md` 决策。主文件只保留四条执行原则：
 
-- 内置 `image_gen` 可用时，普通参考图、视觉变体、已有 UI 效果图保结构重绘和生成型透明素材优先走内置工具。
-- 内置工具不可用，或用户明确要求脚本、Images API、模型、批量、原生透明或固定输出格式时，才走 CLI fallback。
-- 项目绑定图片最终必须复制或移动到项目本地。
-- 真实 API 调用必须使用用户显式配置的 `api_key` 和 `base_url`；运行时数据写入目标项目目录。
-- 通用图标、导航图标、操作图标和状态图标优先使用成熟图标库；图片模型只生成占位或视觉氛围。
-- 图生图视觉变体默认是受控修改，必须保护品牌元素、布局结构、视觉风格和不应变动区域。需要 mask 的局部编辑由 `aisee:image-object` 准备 workspace 和 handoff。
-- Prompt 只注入当前任务必要约束，不把全部规则一次性塞进图片模型请求。
+- 普通参考图、视觉变体和生成型素材明确以 Image2 为目标模型：内置 `image_gen` 可用时优先使用内置工具；CLI/API fallback 默认使用 `gpt-image-2`，只有原生透明等模型能力不支持时才使用其它模型。
+- 透明素材先分流：从零生成的独立主体由本 skill 做 Image2 prompt 完善、绿幕/纯色背景生成和去背景，或按 `references/image-generation.md` 的原生透明 fallback；从已有图片提取透明对象、mask、cutout、修边、去背景和导出变体必须交给 `aisee:image-object`，本 skill 只登记最终产物。
+- 项目绑定图片、prompt 摘要、索引和 brief 必须写入目标项目目录。
+- Prompt 只注入当前任务必要约束，不把全部规则一次性塞进图片模型请求；通用 UI 图标只做占位，最终由图标库替换。
 
 内置脚本：
 

plugins/aisee-plugin/skills/aisee-design-assets/assets/prompt-template-asset.md

@@ -2,11 +2,13 @@
 
 ```text
 任务类型：生成单个可复用设计素材。
+目标模型：Image2 / gpt-image-2
 素材类型：<background | illustration | overlay | layout-layer | transparent>
 目标平台：<mobile | mini-program | h5 | pc | desktop | multi>
 使用位置：<页面/模块/组件>
 建议尺寸：<WIDTHxHEIGHT>
 透明输出：<yes | no>
+透明处理模式：<not-needed | generate-green-screen | native-transparent-fallback | image-object-handoff>
 风格依据：<reference path / StyleSpec path>
 style_anchor：<主参考图 / StyleSpec / design-spec path>
 style_lock：<必须保持的颜色、线条、圆角、材质、光照、构图密度、品牌元素>
@@ -19,6 +21,11 @@ allowed_variation：<允许变化的主体、尺寸、裁切、状态、背景
 输出要求：独立位图素材，可进入项目本地 assets 目录。
 ```
 
+## 透明素材分流
+
+- 从零生成的独立透明素材：本模板可用，默认目标模型写 `Image2 / gpt-image-2`，透明处理模式优先 `generate-green-screen`；需要原生透明且 Image2 不支持时写 `native-transparent-fallback` 并说明原因。
+- 从已有图片提取透明对象、去背景、mask、cutout、修边或导出透明 PNG/WebP：不要使用本模板直接生图，透明处理模式写 `image-object-handoff`，交给 `aisee:image-object` 后只登记最终 export/cutout/enhanced 路径。
+
 ## 图标例外
 
 通用 UI 图标、导航图标、操作图标和状态图标不要使用本位图生成模板。先按 `references/icon-library.md` 映射图标库，并记录语义、图标库、推荐图标、备选图标、尺寸和风格。

plugins/aisee-plugin/skills/aisee-design-assets/references/image-generation.md

@@ -4,6 +4,8 @@
 
 先检查当前会话工具列表是否存在内置 `image_gen` / `image_gen.imagegen`。这是会话工具检测，不是 shell 检测；不能用 `which image_gen` 或查找本地脚本判断。
 
+参考图、视觉变体和生成型素材默认使用 Image2。内置 `image_gen` 可用时优先走内置工具；CLI/API fallback 默认显式指定 `gpt-image-2`。只有原生透明 PNG 等 Image2 不支持的能力，才使用其它模型并在交付中说明原因。
+
 优先使用内置 `image_gen`：
 
 - 普通参考图、视觉草图、背景、插画和素材探索
@@ -156,6 +158,12 @@ python <skill-dir>/scripts/image_gen.py edit \
 
 ## 透明素材
 
+先分流：
+
+- 从零生成透明素材：属于 `aisee:design-assets`。先完成 prompt 优化和一致性合同，再按下面的绿幕/纯色背景或原生透明 fallback 生成。
+- 从已有图片提取透明素材：属于 `aisee:image-object`。包括抠图、去背景、mask、cutout、修边、alpha、导出透明 PNG/WebP、圆角、padding、图层包和背景修补。本 skill 只登记 image-object 的 export/cutout/enhanced 结果。
+- 基于 image-object 过程文件做局部增强：由 `aisee:image-object` 提供 source、mask、bbox、object/cutout 和保护约束，本 skill 只帮助整理 Image2 受控编辑 prompt，候选图仍回写 image-object workspace。
+
 简单、边缘清晰的素材优先走内置 `image_gen` 绿幕方案，再用本地脚本去背景：
 
 ```bash

plugins/aisee-plugin/skills/aisee-design-assets/references/prompt-library.md

@@ -0,0 +1,48 @@
+# 内置 GPT Image 2 中文提示词库
+
+内置中文原始提示词库用于生成参考图、视觉方向、海报、电商图、社媒图、信息图、角色、插画、图标或素材前的 prompt 写法参考。只借鉴结构、描述密度和视觉约束写法，不直接照抄，不引入无关品牌、人物、Logo、文案或业务字段。
+
+路径：
+
+```text
+aisee-design-assets/prompt-library/gpt-image-2/
+├── catalogs/
+│   ├── prompts.jsonl
+│   ├── prompts.csv
+│   ├── prompts.xlsx
+│   ├── excluded.jsonl
+│   └── summary.json
+├── raw-index/
+└── sources.md
+```
+
+日常读取方式：
+
+```bash
+python3 aisee-design-assets/scripts/gpt_image2_prompt_library.py search --intent ui --limit 5
+python3 aisee-design-assets/scripts/gpt_image2_prompt_library.py search --query "电商 主图" --no-risk --limit 5
+python3 aisee-design-assets/scripts/gpt_image2_prompt_library.py read-excel --query "UI 设计系统" --limit 5
+python3 aisee-design-assets/scripts/gpt_image2_prompt_library.py categories
+```
+
+支持的 `--intent`：`asset`、`character`、`ecommerce`、`infographic`、`poster`、`social`、`style`、`ui`。
+
+入库约束：
+
+- 只保留原始语言为中文或 prompt 正文本身为中文的条目。
+- 不把英文、日文、韩文等非中文 prompt 翻译后入库；正文含日文假名或韩文时必须排除。
+- EvoLinkAI 作为默认种子来源，从 canonical cases 中按中文正文筛选。
+- YouMind 作为补充来源，默认通过 sitemap 发现 detail 页，并只保留 detail 页原始 `language/originalLanguage == zh` 的 `content`。
+- `translatedContent` 不能作为入库正文。
+- `catalogs/prompts.xlsx` 面向人工查看，只保留来源、分类、标题、详细提示词、来源链接、许可证、风险备注等精简字段。
+
+刷新来源：
+
+```bash
+python3 aisee-design-assets/scripts/gpt_image2_prompt_library.py build
+python3 aisee-design-assets/scripts/gpt_image2_prompt_library.py discover-youmind-sitemap --limit 20
+```
+
+刷新会访问 GitHub 公开来源和 YouMind 公开 detail 页，并更新 skill 内的 `prompt-library/gpt-image-2/catalogs/` 与 `raw-index/`。如果 YouMind 返回 429，降低 `--youmind-workers` 或稍后再试；脚本会优先使用已缓存的 sitemap URL。
+
+需要追求 YouMind CMS 真正全量时，不要依赖 README 或 sitemap。若有授权的 CMS API 配置，则优先使用 CMS API。无论哪种方式，都只保留原始中文 prompt，不使用 `translatedContent` 作为入库正文。