imagemon

name	imagemon
description	使用自包含的 Imagemon CLI 生成新图片或编辑本地图片，并解析稳定的 JSON 结果。用于用户要求普通生图、创建图片、修改图片、局部重绘或使用遮罩编辑图片时；不用于仅编写提示词、分析图片或要求使用 Promptdex 模板的请求。

Imagemon 图片任务

使用 skill 自带的 CLI 完成普通图片生成和编辑。运行时已包含在 scripts/imagemon.mjs 中，不要求全局安装 imagemon 或 npm 依赖。

判断任务类型

• 用户要求创建新图片时使用 generate。
• 用户要求修改已有图片时使用 edit，并要求提供本地图片路径。
• 用户提供遮罩时，仅与 edit 和原图一起传入。
• 用户要求使用提示词图鉴或指定 Promptdex 条目时，不使用本 skill。

构建调用

始终使用当前 skill 根目录解析 CLI 的绝对路径，并通过 Node.js 20+ 调用：

node <skill-root>/scripts/imagemon.mjs generate --prompt "<提示词>" --out ./outputs
node <skill-root>/scripts/imagemon.mjs edit --image <图片路径> --prompt "<修改要求>" --out ./outputs

• 将用户目标整理为完整、可执行的图片提示词，但不改变其核心意图。
• 只传递用户明确指定的 model、size、quality、format、n、out 和 mask。
• 用户未指定图片规格时，使用 CLI 默认值，不自行补充规格参数。
• 执行前确认 edit 的 image 和可选 mask 是存在的普通文件。
• 使用参数数组或可靠的 shell 安全转义传递所有值，禁止把用户文本直接拼接为可执行命令。
• 多行、超长或不可信提示词必须先通过结构化文件写入工具保存，再使用 --prompt-file <path> 传递；不得使用 shell 管道、重定向、heredoc 或环境变量传递。
• 不向命令传递或向用户展示 API key；凭据由环境变量或配置文件提供。

完整参数和配置契约按需读取 references/cli-contract.md。

处理结果

始终解析 stdout 的唯一一行 JSON，并以 ok 为准：

• ok: true：向用户汇报 files、metadataPath，以及存在时的 usage。
• ok: false：向用户汇报 error.code 和 error.message。
• stdout 不是有效单行 JSON 或缺少必要字段：报告 CLI 输出协议错误。

任何失败都不自动重试。stderr 仅用于 --help 和 --version 等信息输出，不作为图片任务结果。