| name | designkit-edit-tools |
| description | 美图设计室通用图片编辑工具集（AI 修图）。支持智能抠图（背景移除/透明底/白底图） 和 AI 变清晰（画质修复/模糊修复/图片增强）。 当用户提到抠图、去背景、背景移除、matting、SOD、画质修复、变清晰、 图片增强、image restoration 时触发。 |
| version | 1.0.0 |
DesignKit Edit Tools
Overview
通用图片编辑能力集，属于 DesignKit 原子能力层。每项能力输入输出明确、路由简单，既可独立使用，也可被上层 workflow 复用。
能力清单
| 能力 | 操作标识 | 状态 | 描述 |
|---|
| 智能抠图 | sod | ✅ 可用 | 把图片主体从背景里抠出来 |
| AI 变清晰 | image_restoration | ✅ 可用 | 提高图片清晰度 |
意图识别
| 用户说法 | 路由到 |
|---|
| 抠图、去背景、扣图、移除背景、透明底、background removal、matting、cutout | sod |
| 变清晰、画质修复、图片增强、超分、提升画质、修复低清、image restoration | image_restoration |
对话追问策略
智能抠图 (sod)
| 缺省信息 | 是否追问 | 追问话术 |
|---|
| 没有图片 | 必须追问 | "请提供需要抠图的图片（本地路径或 URL）。" |
| 没有说背景色 | 不追问 | 默认按系统方案处理 |
| 没有说比例和尺寸 | 不追问 | 默认按原图尺寸返回 |
典型对话：
用户："帮我把这张图抠一下"
Agent："请提供需要抠图的图片（本地路径或 URL）。"
用户：提供图片
Agent："好的，我来帮你把这张图的主体抠出来。" → 执行
AI 变清晰 (image_restoration)
| 缺省信息 | 是否追问 | 追问话术 |
|---|
| 没有图片 | 必须追问 | "请提供需要变清晰的图片（本地路径或 URL）。" |
| 没说清晰度等级 | 不追问 | 默认高清 |
典型对话：
用户："这张图太模糊了，帮我变清晰"
Agent：（用户已提供图片）"好的，我来帮你提升这张图的清晰度。" → 执行
执行
参数补齐后，调用统一执行器：
bash __SKILL_DIR__/../../scripts/run_command.sh <action> --input-json '<参数JSON>'
示例：
bash __SKILL_DIR__/../../scripts/run_command.sh sod --input-json '{"image":"https://example.com/photo.jpg"}'
bash __SKILL_DIR__/../../scripts/run_command.sh image_restoration --input-json '{"image":"/Users/me/photo.jpg"}'
__SKILL_DIR__ 替换为本 SKILL.md 所在目录的绝对路径。脚本会自动处理本地图片上传。
结果处理
解析脚本输出的 JSON：
ok: true → 从 media_urls 提取结果图 URL，用  展示给用户ok: false → 读取 error_type 和 user_hint，向用户展示可操作的指引
error_type | 用户可见提示 |
|---|
CREDENTIALS_MISSING | 按 user_hint 引导用户配置 |
AUTH_ERROR | 按 user_hint 引导用户核对 |
ORDER_REQUIRED | 前往美图设计室获取美豆 |
PARAM_ERROR | 按 user_hint 补齐参数 |
UPLOAD_ERROR | 检查网络或换一张图片 |
API_ERROR | 换一张图片试试 |
Boundaries
本 skill 只做原子级图片编辑操作。以下场景应转交到对应 skill：
| 不做 | 转交 |
|---|
| 生成电商套图、电商套图、爆款风格套图等多步套图 | designkit-ecommerce-product-kit |
