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

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

## 何时用

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

## 何时不用

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

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

1. 查看和处理已有图片：查 `python3 -c "import PIL"`，
   以及 `convert` / `magick`（ImageMagick）是否存在。
   有其一即可做裁剪、缩放、转格式；都没有就明说。
2. 生成 / 编辑图片：先查任务环境里是否已配置图片生成
   工具或 MCP / API（包括需要什么 key、走哪个 endpoint）。
   没有配置时，回答必须是“本环境未配置图片生成工具，
   无法按描述生成”，并给出替代方案（例如用 shell 画示意图、
   或用户提供已有图片后做裁剪/缩放），绝不能：
   - 把网上找来的图、占位图、已有图片说成是刚生成的；
   - 编造一个图片路径或图片内容描述。

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

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

## 步骤（生成 / 编辑，仅当工具已配置时）

1. 把用户描述原样记下来，不要自己加没说的元素。
2. 调已配置的生成工具，记录工具名、提示词、产出路径。
3. 验证产出图存在且能打开，再交给用户；失败时贴出
   工具报错，不要换一张别的图顶替。

## 输出要求

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