| name | image2 |
| description | Generate images using OpenAI's gpt-image-2 model. MUST trigger when (a) the user invokes the `/image2` slash command, or (b) the user's message begins with the literal token "image2" (case-insensitive) followed by a prompt describing the desired image. Examples that SHOULD trigger this skill: "/image2 a cyberpunk cat", "image2 荷兰橙色的黑胶唱片机", "IMAGE2 poster design --size 1024x1536", "/Image2 sunset over Tokyo". Do NOT trigger for: discussions about the gpt-image-2 model itself without a generation request, requests for other image models (DALL-E, Midjourney, Nano Banana, Stable Diffusion), or image editing/analysis tasks that do not require new generation. |
image2 — OpenAI gpt-image-2 图像生成
执行步骤
Step 1: 解析输入
从用户消息中提取 prompt。处理规则:
- 去掉开头的
/image2 或 image2 (case-insensitive)
- 从尾部识别并剥离以下 flag(其余部分即为 prompt):
--size <WxH> — 尺寸,允许值 1024x1024 / 1536x1024 / 1024x1536--n <1-4> — 生成张数--quality <low|medium|high> — 质量档
- 如果用户只输入了
/image2 或 image2 而没有 prompt,不要调用脚本,直接询问"你想生成什么内容的图片?"
Step 2: 调用脚本
使用 Bash 工具执行:
python "${CLAUDE_PROJECT_DIR:-.}/.claude/skills/image2/scripts/generate.py" \
--prompt "<解析出的 prompt>" \
[--size <size>] [--n <n>] [--quality <quality>]
说明:
- 路径中的
${CLAUDE_PROJECT_DIR:-.} 让 skill 在任意工作目录都能找到脚本;如果 Claude Code 没有注入此变量,默认从当前目录查找
- 只传递用户实际指定的 flag,其余让脚本使用默认值
- 不要 把 API key 作为参数传给脚本,脚本自己会从环境或
.env 读取
Step 3: 展示结果
脚本成功时会在 stdout 打印每张图片的绝对路径,每行一个。拿到路径后:
- 用 Markdown 图片语法展示给用户:
- 在图片下方简短告知保存位置,例如:"已保存到
./image2_outputs/,共 2 张。"
- 不要 重复复述用户的 prompt,也不要加多余的说明文字
脚本失败时(非 0 退出码),把 stderr 的错误信息原样转达给用户,并给出具体的排查建议(参见 README 的故障排查章节)。
约束
- 这个 skill 只负责生图,不处理图生图/图像编辑/图像分析。如果用户要求这些,礼貌说明本 skill 不支持,并建议他们直接调用 OpenAI 的
/v1/images/edits 端点或使用其他工具。
- 不要在用户没有明确要求时,擅自修改或"优化"用户的 prompt。ALSKai 的原则是让用户控制创作,skill 只做执行。
- 如果用户同时指定了超出支持范围的参数(例如
--size 2048x2048),提示正确的允许值,不要静默回退。
上下文
- 默认输出目录:
./image2_outputs/(相对于 Claude Code 当前工作目录)
- API key 来源优先级: 环境变量
OPENAI_API_KEY > skill 目录下的 .env 文件
- 该 skill 的完整使用文档在
./README.md
