# Imagemon

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

- Skill: `dulltackle/imagemon` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add dulltackle/imagemon`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dulltackle/imagemon/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: dulltackle (https://skillmd.com/u/dulltackle)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/dulltackle/imagemon

---


# Imagemon 图片任务

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

## 判断任务类型

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

## 构建调用

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

```bash
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`](references/cli-contract.md)。

## 处理结果

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

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

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