生成图像
通过 OpenAI GPT Image 2 创建图像。身份验证通过已登录 ChatGPT 账户的 Codex CLI 运行,因此图像生成费用由用户的 Plus 订阅覆盖。无需 OpenAI API 密钥,也无需单独按图像计费。
开始之前
本技能不直接与 OpenAI 通信。它通过调用 Codex CLI 实现,且该 CLI 必须已在此机器上安装并已登录到拥有活跃 Plus 订阅的 ChatGPT 账户。请使用 codex --version 检查,如果未登录,运行 codex login。无需粘贴 API 密钥,也没有单独按图像的费用;图像费用计入该订阅。
如果没有登录的 Codex CLI,则任何功能都无法工作,脚本会在第一次调用时直接失败,不会生成文件。
快速开始
# 从本技能自己的目录(无论代理将其安装在哪里)执行
./scripts/generate-image.sh "一只戴着太阳镜的柴犬,摄影棚照片"
保存到解析后的输出文件夹(见下文),文件名为短横线分隔的 PNG,例如:
assets/images/a-shiba-inu-wearing-sunglasses-studio-photo.png
工作流程
- 将用户请求转化为强有力的英文提示。严格按照 PROMPTING.md 中的构建顺序和要点(场景 → 主体 → 细节 → 不变要素 → 用途)。在调用前细化模糊的请求;当素材重要时,不要直接传递简单的单行提示。
- 使用提示运行脚本。可选地传递
--out和--name。 - 将保存的路径报告给用户。如需更改,以小的单变量步骤进行迭代,并重申不变要素(参见 PROMPTING.md)。
输出位置
当未指定 --out 时,脚本自动解析文件夹:
| 条件 | 目标文件夹 |
|---|---|
./public/ 存在(Web/应用项目) | ./public/images/ |
| 其他情况 | ./assets/images/(如果不存在则创建) |
这为所有项目建立了统一的 assets/images/ 约定,同时尊重 Web 项目,其中图像必须位于 public/ 下才能被提供。
选项
| 标志 | 效果 |
|---|---|
--out <dir> | 写入此目录,而非解析后的默认目录 |
--out <file>.png | 写入此确切文件路径 |
--name <basename> | 使用此基本名称,而非将提示转换为短横线分隔格式 |
现有文件永远不会被覆盖:脚本会追加 -2、-3 等后缀。
可交付物命名
这些输出是工作资产,因此默认使用简短的功能名称。如果某个图像是利益相关者的 可交付物,请通过 --name 参数提供明确的名称,遵循文件命名规则,例如:--name "20260612_Hero Banner_v1"
要求
- 已安装
codexCLI(brew install --cask codex) - 已使用 ChatGPT 账户登录:
codex login(Plus 或更高版本;免费版不支持图像生成)
脚本会检查两者,并在缺少时以明确消息失败。