图像处理基础版

概述

本工具是 图像处理 领域的 FREE 版本 AI Skill,专为个人用户与轻量级场景设计。通过自然语言指令驱动 AI Agent 执行任务,提供核心功能与简洁易用的操作体验。

FREE 版本与 PRO 版本完全兼容,可在需要时升级至 PRO 版本获取高级功能、批量操作与团队协同能力。

版本定位

核心能力

FREE 版本提供以下能力:

检查图像尺寸、比例与色彩配置

检查图像尺寸、比例与色彩配置

输入: 用户提供检查图像尺寸、比例与色彩配置所需的指令和必要参数。 处理: 按照skill规范执行检查图像尺寸、比例与色彩配置操作,遵循单一意图原则。 输出: 返回检查图像尺寸、比例与色彩配置的执行结果,包含操作状态和输出数据。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

裁剪、调整大小与格式转换

裁剪、调整大小与格式转换

输入: 用户提供裁剪、调整大小与格式转换所需的指令和必要参数。 处理: 按照skill规范执行裁剪、调整大小与格式转换操作,遵循单一意图原则。 输出: 返回裁剪、调整大小与格式转换的执行结果,包含操作状态和输出数据。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

压缩优化并控制文件大小

压缩优化并控制文件大小

输入: 用户提供压缩优化并控制文件大小所需的指令和必要参数。 处理: 按照skill规范执行压缩优化并控制文件大小操作,遵循单一意图原则。 输出: 返回压缩优化并控制文件大小的执行结果,包含操作状态和输出数据。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

管理 EXIF 与 ICC 元

管理 EXIF 与 ICC 元数据

输入: 用户提供管理 EXIF 与 ICC 元所需的指令和必要参数。 处理: 按照skill规范执行管理 EXIF 与 ICC 元操作,遵循单一意图原则。 输出: 返回管理 EXIF 与 ICC 元的执行结果,包含操作状态和输出数据。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

支持 PNG/JPEG/Web

支持 PNG/JPEG/WebP/AVIF 格式

输入: 用户提供支持 PNG/JPEG/Web所需的指令和必要参数。 处理: 按照skill规范执行支持 PNG/JPEG/Web操作,遵循单一意图原则。 输出: 返回支持 PNG/JPEG/Web的执行结果,包含操作状态和输出数据。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

功能详情

本版本提供 5 项核心能力,覆盖 图像处理 的常见使用场景。如需批量操作、团队协作、数据分析等高级功能,可升级至 PRO 版本。

FREE 版本核心功能清单:

• 检查图像尺寸、比例与色彩配置
• 裁剪、调整大小与格式转换
• 压缩优化并控制文件大小
• 管理 EXIF 与 ICC 元数据
• 支持 PNG/JPEG/WebP/AVIF 格式

PRO 版本扩展功能预览:

• 批量图像处理与自动化流水线
• 响应式图片生成:多尺寸 srcset 自动输出
• CDN 集成与图片上传管道
• 无障碍优化:Alt 文本建议与对比度检查
• 图片质量评分与自动优化建议
• 水印批量添加与品牌资源管理

输入: 用户提供功能详情所需的指令和必要参数。 处理: 按照skill规范执行功能详情操作,遵循单一意图原则。 输出: 返回功能详情的执行结果,包含操作状态和输出数据。 技术参数：使用input_params和output_format参数控制执行行为,支持json/text/csv输出格式。 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：处理与优化图像文、支持格式选择、裁剪压缩与元数据、图像处理领域的专、辅助工具、提供核心基础功能等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。

使用场景

场景 1: Web 图片优化

将图片优化为 Web 友好格式并控制大小

# 转换为 WebP 并压缩
convert input.jpg -resize 1920x -quality 80 output.webp
# 生成多尺寸响应式图片
convert input.jpg -resize 640x small.webp
convert input.jpg -resize 1280x medium.webp

场景 2: 截图处理

截屏后裁剪、标注并优化输出

# 截图裁剪并添加标注
convert screenshot.png -crop 800x600+100+50 -fill red -draw "rectangle 10,10 50,50" annotated.png

不适用场景

以下场景图像处理基础版不适合处理：

• 实时流数据处理
• 小规模数据手动分析
• 非结构化文本情感分析

触发条件

需要数据分析、报表生成、统计洞察、数据可视化时使用。不适用于非本工具能力范围的需求。

快速开始

1. 环境准备

确保已安装并配置好 AI Agent 环境(Claude Code / Cursor / Codex / Gemini CLI 等),本 Skill 通过 SKILL.md 指令驱动 Agent 执行任务。

系统要求:

• 操作系统: Windows / macOS / Linux
• Agent 平台: 支持 SKILL.md 格式的任意 AI Agent
• 运行时: Python 3.8+ 或 Node.js 18+(视具体操作需求)

2. 配置参数

# ImageMagick 基本操作
convert input.jpg -resize 50% -quality 85 output.jpg
# 批量转换
mogrify -format webp -path output/ *.jpg
# 检查图片信息
identify -verbose image.png | head -20

3. 验证配置

配置完成后,可通过以下方式验证是否正常工作:

# 验证环境变量是否设置
echo "配置检查:"
env | grep -E "API|KEY|TOKEN|SECRET" | sed "s/=.*/=***/"  # Linux/macOS
# 或 PowerShell
# Get-ChildItem Env: | Where-Object {$_.Name -match "API|KEY|TOKEN"} | Format-Table

4. 开始使用

在 AI Agent 对话中描述你的需求,Agent 会根据本 Skill 的指令自动执行对应操作。

请帮我Web 图片优化

Agent 将自动:

1. 解析你的自然语言指令
2. 调用相应的工具或 API
3. 执行操作并返回结果
4. 返回执行结果供你确认

命令参数说明

• -Table: 命令参数,用于指定操作选项
• -E: 命令参数,用于指定操作选项
• -ChildItem: 命令参数,用于指定操作选项
• -Object: 命令参数,用于指定操作选项

示例

基础配置

# ImageMagick 基本操作
convert input.jpg -resize 50% -quality 85 output.jpg
# 批量转换
mogrify -format webp -path output/ *.jpg
# 检查图片信息
identify -verbose image.png | head -20

可选配置

{
  "edition": "free",
  "auto_retry": false,
  "max_concurrent": 1,
  "log_level": "info",
  "cache_enabled": true,
  "timeout": 30
}

FREE 配置项说明:

最佳实践

1. 先确定宽高比再裁剪,最后压缩
2. 不要默认放大图片,额外像素不创造细节
3. Web 图片通常使用 sRGB 色彩空间
4. 保留原始主文件,只导出交付版本

个人使用建议

• 从简单任务开始熟悉工具行为,逐步扩展到复杂场景
• 定期备份配置文件与数据,防止意外丢失
• 遇到问题先查阅常见问题章节,再寻求社区帮助
• 保持配置简洁,只启用必要的功能选项
• 定期更新工具版本以获取最新功能与修复
• 记录常用操作命令,提高日常使用效率

常见问题

Q: 透明图片保存为 JPEG 丢失透明度?

A: JPEG 不支持透明通道,请使用 PNG 或 WebP 格式。

Q: 截图用 JPEG 模糊怎么办?

A: 截图含文字等锐利边缘,应使用 PNG 或无损 WebP。

Q: 如何升级到 PRO 版本?

A: 升级到 PRO 版本非常简单:

1. 获取 PRO 版本授权
2. 安装 PRO 版本 Skill
3. 原有配置自动迁移,无需额外操作
4. 即可使用批量操作、团队协作等高级功能

已知限制

A: FREE 版本主要限制:

• 不支持批量操作(每次只能处理一个任务)
• 不支持团队协作(仅限个人使用)
• 不支持高级数据分析
• 技术支持依赖社区 如需这些功能,建议升级至 PRO 版本。

Q: FREE 版本的数据安全吗?

A: FREE 版本所有数据本地存储,不上传云端,确保隐私安全。建议定期备份配置文件与数据目录。

依赖说明

运行环境

• Agent 平台: 支持 SKILL.md 的任意 AI Agent(Claude Code / Cursor / Codex / Gemini CLI 等)
• 操作系统: Windows / macOS / Linux
• 运行时: Python 3.8+ 或 Node.js 18+(视具体操作需求)
• 网络: 部分功能需要网络连接访问外部 API

依赖详情

API Key 配置

FREE 版本支持单一 API Key 配置,满足个人使用需求:

• 环境变量:通过环境变量配置 API Key
• 配置文件:支持配置文件方式存储 API Key
• 安全提醒:切勿将 API Key 硬编码到脚本或提交到版本控制系统

可用性分类

• 分类: MD+EXEC(纯 Markdown 指令,部分功能需要 exec 命令行执行能力)
• 说明: 基于 Markdown 的 AI Skill,通过自然语言指令驱动 Agent 执行任务
• FREE 特性: 支持单次执行、基础配置与社区支持
• 安全等级: 基础,数据本地存储,建议定期备份
• SLA: 社区支持,尽力响应

版本信息

错误处理