这个 Skill 能做什么，适合哪些场景？
imagegen 是 OpenAI Codex 仓库中捆绑的一个技能，教 Codex 何时以及如何生成或编辑光栅图像。它默认优先使用 Codex 内置的 image_gen 工具，无需 API 密钥；仅在用户明确要求 CLI/API 路径或需要真正的原生透明背景时，才切换到随附的 scripts/image_gen.py 命令行工具（需 OPENAI_API_KEY）。技能内置了分类标签体系、共享提示词模板、批量生成策略、以及用色度键背景加本地脚本去除背景来生成透明 PNG/WebP 的完整流程。它明确划定了边界：SVG、图标、logo 等代码原生资产应直接编辑，而不是用 AI 生成位图替代。
- 通过内置 image_gen 工具生成新图像（概念图、产品图、网站 hero、UI mockup 等）或基于参考图生成风格一致的变体
- 对会话上下文中已有的图像执行编辑：局部重绘、换背景、移除对象、合成、光照/天气变换
- 为批量需求逐条调用内置工具，或在 CLI 模式下使用 generate-batch 子命令一次处理多提示词
- 透明背景请求先用色度键背景（默认 #00ff00）生成，再用 remove_chroma_key.py 脚本本地转成带 alpha 的 PNG/WebP
- 按保存路径策略把项目用素材从 $CODEX_HOME/generated_images/ 移入工作区，并用版本化文件名避免覆盖
- 在 CLI 回退模式下通过 scripts/image_gen.py 调用 gpt-image-2（支持 quality、尺寸控制，最大 3840px）
- 前端开发者在 Codex 中为落地页快速生成 hero 图、产品 mockup 或 UI 视觉稿，直接产出到工作区
- 游戏开发者批量生成贴图、精灵图等位图素材，且要求最终文件落到项目目录
- 营销/设计人员需要把产品照片换成新背景或做光照、天气等编辑，同时严格保留产品本身不变
- 需要透明背景图标或素材的用户，走色度键加本地抠图流程，复杂主体（毛发、玻璃、烟雾）则确认后走 gpt-image-1.5 原生透明
- 需要在同一任务里产出多个变体（如广告创意的多个版本）的用户
- 需要扩展仓库内已有的 SVG/图标/logo 体系或绘制简单形状、图表的场景——技能明确要求直接编辑代码原生资产而非生成位图
- Codex 之外的环境：内置 image_gen 工具和 $CODEX_HOME 路径约定是 Codex 专属的，其他平台只能使用需改造的 CLI 回退路径
- 不愿配置 OPENAI_API_KEY 又需要 CLI 模式（质量/尺寸/遮罩等精细控制）的用户——该路径必须设置密钥
如何安装这个 Skill？
- 核心图像生成依赖外部模型服务；提示词和输入图像的数据处理、保留及隐私边界未在技能文档中明确说明。
- CLI模式需要OPENAI_API_KEY、Python依赖和网络访问；中国大陆用户可能遇到服务可达性或网络审批问题。
- 源码未提供覆盖关键路径的测试或CI证据，生成质量、文字准确性、透明背景边缘和编辑不变量必须人工验证。
- Shell / 命令行
- 网络访问
- 本地文件系统
Python (openai, pillow packages)OPENAI_API_KEY (CLI fallback only)Codex built-in image_gen tool (default mode)
该技能是 Codex 仓库内置的示例/系统技能之一，随 Codex 安装分发，无需单独安装。
Codex（安装 Codex CLI，技能随仓库提供）
curl -fsSL https://chatgpt.com/codex/install.sh | sh或
npm install -g @openai/codexCLI 回退模式依赖（如需使用 scripts/image_gen.py）
uv pip install openai
uv pip install pillow如何使用这个 Skill？
安装后，把下面任意一句发给 Agent 即可触发：
- 为我们的落地页生成一张极简风格的陶瓷咖啡杯 hero 图，柔和摄影棚打光，无 logo 无文字，保存为 assets/hero.png
- 把产品照片 hero.jpg 的背景换成暖色日落渐变，只改背景，产品和边缘保持不变
- 在纯 #00ff00 色度键背景上生成一个吉祥物图标，然后去掉背景输出透明 PNG 到 assets/mascot.png
- 用 CLI 模式批量生成 5 个不同风格的广告创意横幅，输出到 output/imagegen/
技能由 Codex 根据任务描述自动触发。默认流程：先判断模式（内置 image_gen 优先，CLI 回退仅在用户明确要求或确认原生透明时使用），再判断意图（generate 或 edit）、输出用途（仅预览还是项目资产）和执行策略（单张/多次调用/generate-batch）。用户会给出提示词、精确文字、约束和输入图；技能会标注每张输入图的角色，编辑本地文件前先用 view_image 加载到上下文。透明请求走色度键流程：
python "${CODEX_HOME:-$HOME/.codex}/skills/.system/imagegen/scripts/remove_chroma_key.py" \
--input <source> \
--out <final.png> \
--auto-key border \
--soft-matte \
--transparent-threshold 12 \
--opaque-threshold 220 \
--despillCLI 回退模式下可用 generate / edit / generate-batch 三个子命令，中间文件放 tmp/imagegen/，最终产物写 output/imagegen/。注意：普通的质量、尺寸、路径控制不构成切换 CLI 的理由；从内置工具或 gpt-image-2 降级到 gpt-image-1.5 必须先询问用户。
这个 Skill 有哪些优点和局限？
- 内置工具模式无需 API 密钥，开箱即用
- 规则极其明确：何时用内置、何时回退、何时必须询问用户，减少误用
- 自带完整提示词模板、用途分类标签体系和逐资产类型的示例
- 透明背景有可执行的本地色度键处理方案，含边缘羽化、despill 等细节参数
- 明确的保存路径与防覆盖策略，避免项目资产遗留在默认目录
- 强绑定 Codex 生态：内置 image_gen、view_image、$CODEX_HOME 均为 Codex 专属，移植到其他 Agent Skills 客户端需要改写
- 真正的原生透明背景必须降级到 gpt-image-1.5（gpt-image-2 不支持 background=transparent），且需 OPENAI_API_KEY
- 色度键抠图对毛发、烟雾、玻璃等复杂主体效果有限
- 技能规定不得修改 scripts/image_gen.py，定制受限
- 仓库主题标签为空，且 README 面向整个 Codex CLI，针对此技能的独立文档有限
这个 Skill 与同类方案有什么区别？
与相关 Skills 并排比较；分数均按同一 FSRS 标准得出。
| Skill | FS 评分 | Star 数 | 最近更新 | License |
|---|---|---|---|---|
| Codex 图像生成技能（imagegen） 本页 ✓ OpenAI · 官方 | 56 · 谨慎使用 | ★ 129k | 11 天前 | Apache-2.0 |
| GPT Image 2 图像创作工作流 | 53 · 谨慎使用 | ★ 13k | 15 天前 | MIT |
| Banana Claude —— Gemini 图像创作指挥技能 | 59 · 推荐 | ★ 1.1k | 7 天前 | MIT |
| 学术配图提示词生成器（现代柔彩 ML 风格） | 68 · 推荐 | ★ 2.6k | 7 个月前 | MIT |
| 学术论文配图提示词生成器 | 69 · 推荐 | ★ 2.6k | 7 个月前 | MIT |
技能本身在文档中对比了两条执行路径：内置 image_gen 工具（默认，免密钥，透明背景靠色度键后处理）与 CLI 回退（scripts/image_gen.py + gpt-image-2/1.5，需要密钥，支持质量、尺寸、遮罩、原生透明）。二者是互补而非竞争关系。
FollowSkills 如何评估这个 Skill？
文档明确区分内置工具与CLI、要求用户确认透明度降级、避免覆盖文件、限制API密钥处理，并说明网络审批风险；但未完整披露上传图像与提示词的数据流、隐私保留策略、内置工具的外部影响或通用回滚机制，因此扣7分。
脚本和文档包含参数校验、缺失依赖提示、输出冲突保护、批处理上限及部分瞬态错误重试，静态看主路径较清晰；但没有提交测试套件或执行证据，内置工具失败覆盖和异常恢复仍有限，按静态上限扣分。
适用场景、生成/编辑区分、非适用范围、触发规则和输出策略描述充分；但没有中文提示或本地化支持说明，CLI依赖OpenAI网络服务，面向中国大陆网络环境的可达性与替代路径证据不足，因此扣5分。
信息架构、渐进披露、CLI依赖、参数、示例、限制和引用关系较完整；但技能本身未提供版本号、变更日志、维护责任或更新流程，许可证与发布治理主要依赖外部元数据，因此扣4分。
技能覆盖生成、编辑、批量资产、透明背景和项目落盘，并规定输出路径与检查流程，核心任务价值明确；但生成结果质量、文本准确性和迭代效果没有静态可验证证据，仍需人工复核，因此扣1分。
SKILL.md、参考文档和CLI源码提供了可审计的规则、参数及错误信息，部分主张可由源码复核；但缺少提交测试、CI覆盖或第三方运行记录，无法支持更高静态分数。
点击维度查看打分理由
证据充分度：低 — 主要依赖静态检查、作者材料或有限演示；适合发现线索，不适合做高风险决策。
查看完整评分方法 →