gpt-icon-generate

GPT Icon Generation Skill

用途

• 生成图标、图标包、应用图标、UI 图标、产品功能图标。
• 生成规则网格图标板，并拆分成透明 PNG 单图。
• 默认走 2K、1:1、4x4 / 16 icons、白底、贴合图标轮廓描边/外发光/柔和阴影。
• 用户可以指定行数、列数、尺寸、比例、MCP 工具、pad、border、fuzz、postprocess 等参数。
• 不支持自由散排；如果生成结果不是规则网格，应重新生成，不要强行切图。

MCP 与路径

• 本项目 MCP 配置文件：.opencode/opencode.json
• 默认图片 MCP 工具：image-generate-mcp-remote_gpt_image_2_official
• 临时探索工具：image-generate-mcp-remote_gpt_image_2_temporary
• 生成前优先调用 image-generate-mcp-remote_list_image_tools_catalog_tool 检查当前工具支持的 size preset。
• 推荐输出路径：当前工作目录下的明确绝对路径，例如 /home/base/repo/document/app-icons-sheet.png

默认流程

如果用户没有特别指定，使用以下默认流程：

1. 使用 image-generate-mcp-remote_gpt_image_2_official。
2. 生成 2048x2048、1:1、纯白背景图标板。
3. 图标布局为 4x4，共 16 个图标；expected_count = rows * cols。
4. 提示词要求每个图标都有贴合自身轮廓的外描边、外发光或柔和阴影。
5. 不要要求远离图标的方形卡片框、圆角矩形底板、大面积 backplate 或 tile。
6. 生成后运行 verify_image_output.py 校验实际宽高、比例、通道。
7. 用实际宽高和行列运行 plan_icon_sheet_params.py 计算切图参数。
8. 用 split_icon_sheet_connected_bbox.py 做整图连通域切图。
9. 如需 UI 图标库，把每张图等比缩放后居中放入计算得到的透明画布，不固定写死 512x512。

可配置参数

• rows：图标板行数，默认 4
• cols：图标板列数，默认 4
• size：生成尺寸，默认 2048x2048
• aspect_ratio：图片比例，默认 1:1
• tool：图片生成工具，默认 gpt_image_2_official；陌生兼容站点试跑时才使用 gpt_image_2_temporary
• fuzz：背景 floodfill 容差，默认 1.5%
• pad：组件 bbox 外扩像素，默认由实际图片尺寸计算
• border：透明图标边缘留白，默认由实际图片尺寸计算
• min_area：主组件最小面积阈值，默认由实际图片尺寸计算
• postprocess：透明边缘后处理模式，默认 baseline，可选 alpha_open_blur

expected_count 不需要用户指定，始终等于 rows * cols。

工具选择规则

1. 默认使用 image-generate-mcp-remote_gpt_image_2_official。
2. 如果用户明确要求 right.codes draw 兼容链路，优先要求服务启动时将 IMG_GEN_GPT_IMAGE_2_OFFICIAL_PRESET 配置为 right_codes_gpt_image_2，仍使用 image-generate-mcp-remote_gpt_image_2_official。
3. 只有在探索陌生 OpenAI Images 兼容站点、且还没有正式 preset 时，才使用 image-generate-mcp-remote_gpt_image_2_temporary。
4. 如果目标尺寸不被当前工具支持，选择同宽高比下最接近的可用尺寸，并告知用户。
5. 如果请求 2K 但实际返回 1K，不直接失败；必须以实际输出尺寸重新计算切图参数。

生成建议

• 明确要求 exactly {expected_count} icons in a {rows}x{cols} regular grid。
• 明确要求 canvas size {width}x{height}。
• 明确要求 pure white page background。
• 明确要求 ample padding between icons。
• 明确要求 each icon centered in its own cell。
• 优先要求每个图标外面有贴合图标轮廓的细、柔和、可见但不过厚的阴影轮廓，便于后续稳定切图。
• 不要生成远离图标的正方形卡片框、圆角矩形底板、大面积 backplate 或 tile；外框应像贴纸描边一样沿图标外轮廓包裹。
• 若需要透明底，提示词里写 transparent background with real alpha channel，并在生成后验证。
• 若模型经常生成伪透明图，不要继续强依赖 alpha，改为生成纯白背景 + 每个图标外贴合轮廓的描边/外发光/柔和阴影。