AGY Image Generation Skill
通过本地安装的 agy CLI 代理调用其内置图像生成模型，生成任意类型的高质量图片并保存到指定路径。支持各种风格：写实、插画、概念设计、游戏素材、Logo、UI 元素等。
适用场景
- 生成任意风格的图片（写实照片、插画、概念艺术、图标、Logo 等）
- 游戏素材、UI 设计元素
- 通过命令行批量调用生图
- 利用 agy 背后的模型（Gemini / Claude / GPT-OSS）进行图像生成
前置条件
- 已安装 agy CLI
- Windows: 默认路径
%LOCALAPPDATA%\agy\bin\agy.exe - macOS/Linux: 通常在
~/.local/bin/agy或通过which agy确认
- Windows: 默认路径
- agy 已配置好模型 API
- 如需输出真正的 PNG 格式，需安装 ImageMagick
核心调用方式
Windows（PowerShell）
CMD 引号嵌套会截断中文提示词，必须用 PowerShell：
$prompt = Get-Content 'prompt.txt' -Raw
$agy = Join-Path $env:LOCALAPPDATA 'agy\bin\agy.exe'
& $agy -p $prompt --print-timeout 3m0s --dangerously-skip-permissions
macOS / Linux（Bash）
prompt=$(cat prompt.txt)
agy -p "$prompt" --print-timeout 3m0s --dangerously-skip-permissions
prompt.txt 内容格式
请使用你的图像生成工具，生成一张图片并保存到 /path/to/output.jpg。图片描述如下：your image description here
重要：图片格式问题
agy 生成的图片本质上是 JPEG 格式，即使保存路径指定了 .png 扩展名，实际文件内容仍然是 JPEG。
- 默认保存为
.jpg即可，避免格式混淆 - 如需真正的 PNG（透明背景或下游 API 要求严格 MIME 校验），先保存 .jpg 再转换：
magick output.jpg output.png
- 不要直接让 agy 保存为 .png，否则传给 AWS Bedrock 等 API 时会报 IMAGE_MIME_MISMATCH 错误
关键参数
| 参数 | 作用 |
|---|---|
-p / --print |
非交互模式，执行完输出结果 |
--print-timeout 3m0s |
生图超时（建议 3-5 分钟） |
--dangerously-skip-permissions |
跳过工具权限确认，避免阻塞 |
安装方式
- 创建目录
~/.jimu/skills/agy-image-gen/ - 将 SKILL.md 文件放入该目录
- 在积木中执行
jimu:skill agy-image-gen注册
触发词：agy生图、agy画图、用agy生成图片、agy image、agy generate image