---
name: image-workflow
description: 查看、裁剪、缩放、格式转换已有图片，或在图片生成工具已配置时按描述生成/编辑图片时使用。未配置生成工具时必须明说无法生成，绝不把已有图片或占位图当成生成结果。
---

# image-workflow：图片查看与处理

## 何时用

- 查看已有图片、裁剪、缩放、转格式、读图片尺寸和格式。
- 用户明确要求“按描述生成一张图”或“按描述改这张图”，
  且本环境已配置图片生成工具 / API 时。

## 何时不用

- 只是写代码、改文本、查文档：不用本技能。
- 用户要生成图片，但本环境没有生成工具：不要硬做，
  走下面的“未配置”分支。

## 工具前提（先核查，不满足就明说）

1. 查看和处理已有图片：查 `python3 -c "import PIL"`，
   以及 `convert` / `magick`（ImageMagick）是否存在。
   有其一即可做裁剪、缩放、转格式；都没有就明说。
2. 生成图片：本环境已配置图片生成 MCP 工具
   `image_generate`（中转站图片分组，走系统级 key，不用
   任务自己的网关 key）。调用它生成，不要自己去调
   `/v1/images/generations`，也不要编造 key 或 endpoint。
   参数：`prompt`（必填）、`output_filename`（工作区内的
   文件名，如 `hero.png`）、`size`（1024x1024 / 1536x1024 /
   1024x1536，默认 1024x1024）。工具返回绝对路径、格式、
   尺寸、字节数；失败时工具直接报错，不要换图顶替。
   如果工具列表里没有 `image_generate`，或调用它报
   “image generation not configured”，回答必须是“本环境
   未配置图片生成工具，无法按描述生成”，并给出替代方案
   （例如用 shell 画示意图、或用户提供已有图片后做裁剪/
   缩放），绝不能：
   - 把网上找来的图、占位图、已有图片说成是刚生成的；
   - 编造一个图片路径或图片内容描述。
   编辑已有图片：用 `image_edit` 工具，参数 `prompt`（改什么）、
   `input_filename`（工作区内已有图的文件名）、
   `output_filename`（新文件名，必须与输入不同，原图绝不
   被覆盖）、`size`。改图产出是新文件，不是原图修改；
   同样要用 shell / PIL 重新打开验证后再交给用户。

## 步骤（已有图片处理）

1. 先读原图信息：格式、尺寸、文件大小，确认输入路径存在。
2. 按用户要求做裁剪 / 缩放 / 转格式，产出到用户指定的
   路径（未指定时用工作区内的新文件名，不覆盖原图）。
3. 验证产出：重新打开产出图，确认格式、尺寸符合要求，
   文件大小不是 0。

## 步骤（生成 / 改图，仅当对应工具在位时）

1. 把用户描述原样记下来，不要自己加没说的元素。
2. 生成调 `image_generate`，改图调 `image_edit`（输入图
   必须是工作区内已存在的文件，产出文件名与输入不同），
   记录提示词、尺寸、产出路径。
3. 验证产出：用 shell / PIL 重新打开返回路径的图，确认
   格式、尺寸符合要求，文件大小不是 0，再交给用户；
   失败时贴出工具报错，不要换一张别的图顶替。

## 输出要求

- 每个产出图都要给真实路径和尺寸，生成类还要给提示词。
- 未配置时不要绕弯子说“已生成”，直接说缺什么、
  用户补什么才能生成。