83.3K+下载
跳转到使用指南
imagegen作者 OpenAI

ImageGen Skill.

Claude Code 和 Codex 的图像处理 skill：生成或编辑位图图像，包括插图、照片、纹理、精灵图、样机。

  • Images & Generative Art
  • Image
下载 OpenDesign查看使用指南
openai/skills · skills/.system/imagegen/SKILL.mdSKILL.md
--- name: imagegen description: Generate or edit raster images when the task benefits from AI-created bitmap visuals such as photos, illustrations, textures, sprites, mockups, or transparent-background cutouts. Use when Codex should create a brand-new image, transform an existing image, or derive visual variants from references, and the output should be a bitmap asset rather than repo-native code or vector. Do not use when the task is better … --- ## Top-level modes and rules ## When to use ## When not to use ## Decision tree ## Workflow ## Prompt augmentation
从上游文件读取的前置内容和章节标题，2026-09-14 · 完整内容 16,170 字符

01 功能说明

imagegen skill 在 Claude Code 和 Codex 中的作用

摘要、工作流与产物，均读自该 skill 的 SKILL.md。

来自 SKILL.md读取于 2026-09-14 · 非实际运行记录

以 skill 自身的术语

Imagegen 为 Codex 提供了一套光栅图像工作流：生成或编辑照片、插图、纹理、贴图、样机以及透明背景切图等位图素材，然后将成品文件放入项目中。它定义了两种顶层模式：首选的内置 image_gen 工具（无需 API key），以及仅在明确要求时使用的、通过 scripts/image_gen.py 实现的 CLI 后备方案（需要 OPENAI_API_KEY）。

该文件将意图（生成还是编辑）与执行（单个素材还是多个）区分开来，收集提示词、逐字文本、约束条件以及带角色标签的输入图像，并将其重塑为带标签的结构化数据。最后以对主体、风格、构图和文字准确性的校验、单点迭代式修改以及非破坏性保存作为结束。

它产出什么

  • 当用户要求光栅风格素材时，通过 image_gen 生成的位图图像，而非 SVG、HTML/CSS 或 canvas 占位图。
  • 选定的最终图像会被移动或复制到工作区中，并更新所有引用或调用该图像的代码，使其指向新位置。
  • 一份结束报告，给出任何绑定到工作区的素材的最终保存路径、最终提示词，以及由哪种模式生成。
  • 仅在明确的 CLI 后备方案中，最终产物会写入 output/imagegen/ 下。
查看示例提示词 ↗

工作方式

  1. 01
    先选定顶层模式

    常规的生成和编辑操作通过内置的 image_gen 工具完成；捆绑的 CLI 是一种后备方案，用户必须明确指名才会使用。

  2. 02
    将请求分类为生成或编辑

    在保留原图部分内容的基础上修改现有图像属于编辑；仅将图像作为风格、构图或情绪参考提供时，仍属于生成。

  3. 03
    决定输出内容的存放位置

    预览或头脑风暴性质的工作可以保留在默认位置的内联状态，而任何被项目实际使用的内容都必须最终存放到工作区中。

  4. 04
    生成前先收集输入

    提前收集 prompt、图内需精确呈现的文字、约束或禁止项清单，以及全部输入图像，而不是后续再补齐缺口。

  5. 05
    将 Prompt 重塑为规格说明

    Prompt 会被规范为结构化、面向生产的规格说明，而不是添加未被要求的创意细节来扩写。

  6. 06
    每个产物发起一次调用

    在内置路径中，批量与变体来自对 image_gen 的多次重复调用——每个所需产物或变体一次，而不是依靠单一批量标志。

02 找到适合场景

何时使用 imagegen Skill

当工作是此类图像工作时，在 Claude Code 或 Codex 中使用 imagegen skill。下面的适用范围和限制来自 skill 自身的文件。

适合场景

  • 生成全新的位图，例如概念图、产品图、封面或网站主视觉图像。
  • 生成新图像，其中提供的图像仅作为风格、构图或氛围的参考。
  • 编辑现有图像，用于光照或天气变化、背景替换、物体移除、合成或透明背景抠图等任务。
  • 为单个任务生成多个产物或变体，而不是一张图像。

了解边界

  • 扩展或匹配仓库中已存在的 SVG/矢量图标集、logo 体系或插图库。
  • 直接用 SVG、HTML/CSS 或 canvas 构建更清晰的简单形状、图表、线框图或图标。
  • 源文件已以可编辑的原生格式存在时，对项目本地资源进行的小范围编辑。
  • 任何用户明显希望得到确定性、代码原生输出而非生成位图的任务。

需要提供的信息

  • 主要请求用户的主要 prompt 提供了主体与目标，并作为主要请求行被带入规格说明。
  • 带明确角色的输入图像每张提供的图像在生成前都会被标注为参考图像、编辑目标，或作为辅助插入／风格／合成输入。
  • 精确文字及其排版图像中必须出现的文字会被逐字引用，并同时指定字体与放置位置。
  • 不变量与禁止项清单对于编辑任务，必须明确写出不可改变的内容，例如仅更改 X 同时保持 Y 不变。
  • 产物的预期用途说明该图像是广告、UI 原型还是信息图，决定了 prompt 所针对的模式与精致程度。

03 Skill 内部

imagegen Skill 为 Claude Code 与 Codex 设定的规则

SKILL.md 为 Agent 设定的 8 条具体指令、默认值与限制——文件中真正改变结果的部分。

  1. 内置工具是默认选项

    每一次常规的生成或编辑请求都会经过内置的 image_gen 工具，该工具不需要 OPENAI_API_KEY。

  2. 绝不自行降级

    Agent 不得自行切换到 CLI 路径；该切换始终由用户决定。

  3. 仅在被要求时使用 CLI

    如果用户确实选择了 CLI 模式，请使用内置的 scripts/image_gen.py 工作流，不要编写一次性的 SDK 运行脚本。

  4. 内置脚本是只读的

    scripts/image_gen.py 永远不会被修改；如果其中缺少某项内容，应先询问用户，再进行其他操作。

  5. 项目资产不能留在 $CODEX_HOME 中

    任务完成前，必须将项目引用的文件从默认的生成图片位置移出或复制出去。

  6. 使用版本化而非覆盖

    只有当用户明确要求替换时，才会替换现有资产；否则新文件会以并列的版本化名称保存，例如 hero-v2.png。

  7. 编辑时保留不变量

    编辑工作会锁定哪些内容不得更改，并以非破坏性方式保存，而不是重写源资产。

  8. 内置路径中不处理密钥

    Agent 在使用 image_gen 时从不询问 OPENAI_API_KEY，也从不要求用户在聊天中粘贴完整密钥。

04 投入使用

在 Claude Code 或 Codex 中安装 imagegen

一条 npx skills add 命令，然后在你的 Agent 中执行第一个任务和对结果的清单检查。

将 imagegen 添加到 Claude Code、Codex 或您的 Agent

在你的项目中运行；安装程序会询问要把它添加到哪个 Agent。

Terminal
npx skills add https://github.com/openai/skills --skill imagegen

针对 skills/.system/imagegen/SKILL.md 的通用 skills CLI 形式；仓库可能会记录其自身的路径。

给 Skill 一个首次图像工作任务

使用你自己的内容和约束调整此提示，然后在 Claude Code 或 Codex 中运行它。

Example prompt
Use case: product-mockup Asset type: landing page hero Primary request: a minimal hero image of a ceramic coffee mug Style/medium: clean product photography Composition/framing: wide composition with usable negative space for page copy if needed Lighting/mood: soft studio lighting Constraints: no logos, no text, no watermark

来源：SKILL.md 示例（原文照录）。

检查首次结果

SKILL.md 本身如何描述正确的结果：

  • 对照主体、风格、构图、文字准确性以及事先约定的不变量和应避免的事项检查输出。
  • 随后进行一次有针对性的修改并重新检查，而不是将多个修改合并到一次迭代中。
  • 对于编辑，每次迭代都要重新说明不变量，以避免图像偏离必须保持不变的内容。

在 OpenDesign 中imagegen 是内置的：Plugins → Skills，在顶部栏中选择它。

下载 OpenDesign阅读快速入门

05 开源、可追溯

来源、许可与验证

本页面事实的来源，以及最后检查时间。

Author
OpenAI
Repository
github.com/openai/skills 分支 main
Skill 文件
skills/.system/imagegen/SKILL.md 验证时记录的内容校验和；提交 49f948f
License
Apache-2.0 来自 skills/.system/imagegen/LICENSE.txt。该 skill 是开源的；图像生成仍依赖托管服务。
仓库星标数
27,129 GitHub 快照拍摄于 2026-09-14，针对整个 openai/skills 代码仓库。不是 imagegen 的评分或使用数量。
已由 OpenDesign 验证
2026-09-14 已检查源文件、路径、许可证文本和星标数。已捆绑在 OpenDesign 主版本中（检查于 2026-08-28）；此页面尚未记录实际运行。

SKILL.md 内部

  1. 顶层模式与规则内置 image_gen 为默认方式；CLI 回退仅在明确指定时使用，并有保存路径优先级和覆盖限制。
  2. 何时使用新图像、参考引导生成、对现有图像的编辑，以及大量资产或变体。
  3. 何时不使用仓库原生的矢量系统、代码原生形状、可编辑的原生文件，以及确定性的代码原生输出。
  4. 决策树将意图（生成还是编辑）与执行策略（单个资产还是多个资产）区分开来。
  5. 工作流从模式选择到提示词构建、生成、验证与报告，共十七个有序步骤。
  6. 提示词增强将提示词组织成生产规格，允许的和禁止的增强项按具体程度分类。
  7. 用例分类（精确 slug）固定的生成与编辑 slug，以在提示词和参考资料间保持一致。
  8. 共享 prompt 模式带标签的脚手架字段，如资源类型、场景、主体、光照、逐字文本和 avoid 列表。
  9. 示例一份主图生成规范和一份背景替换编辑规范，后者列出了其不变量。
  10. Prompt 最佳实践顺序安排、精确引用文本、为多张图片编号，以及通过单次改动的后续操作进行迭代。
  11. 按资源类型给出的指引将网站、游戏、线框图和 logo 工作的资源类型模板指向 sample-prompts.md。
  12. 仅限回退 CLI 模式CLI 的临时文件与输出约定、uv 依赖项，以及 OPENAI_API_KEY 的设置步骤。
Skill 自身的描述
"当任务受益于 AI 创建的位图视觉效果（如照片、插画、纹理、精灵图、mockups 或透明背景的剪贴图）时，生成或编辑栅格图像。在 Codex 需要创建全新图像、转换现有图像或从参考图派生视觉变体，且输出应该是位图资源而非仓库原生代码或矢量时使用。当任务更适合通过编辑现有 SVG/矢量/代码原生资源、扩展已建立的图标或 logo 系统，或直接在 HTML/CSS/canvas 中构建视觉效果时，不要使用。"

来自 SKILL.md 的前置元数据描述。完整文件约 16,170 个字符。在 GitHub 上阅读完整文件。

ImageGen

在真实图像工作任务上运行 imagegen。

imagegen skill 内置于 OpenDesign。下载应用，在 Plugins → Skills 中选择该 skill，粘贴上面的提示词，并在查看结果之前阅读计划。

下载 OpenDesign浏览所有 skills
终端
npx skills add https://github.com/openai/skills --skill imagegen