Codex 图像生成技能
在项目中生成、编辑并管理面向实际用途的位图图像资产。
文档明确区分内置工具与CLI、要求用户确认透明度降级、避免覆盖文件、限制API密钥处理，并说明网络审批风险；但未完整披露上传图像与提示词的数据流、隐私保留策略、内置工具的外部影响或通用回滚机制，因此扣7分。
脚本和文档包含参数校验、缺失依赖提示、输出冲突保护、批处理上限及部分瞬态错误重试，静态看主路径较清晰；但没有提交测试套件或执行证据，内置工具失败覆盖和异常恢复仍有限，按静态上限扣分。
适用场景、生成/编辑区分、非适用范围、触发规则和输出策略描述充分；但没有中文提示或本地化支持说明，CLI依赖OpenAI网络服务，面向中国大陆网络环境的可达性与替代路径证据不足，因此扣5分。
信息架构、渐进披露、CLI依赖、参数、示例、限制和引用关系较完整；但技能本身未提供版本号、变更日志、维护责任或更新流程，许可证与发布治理主要依赖外部元数据，因此扣4分。
技能覆盖生成、编辑、批量资产、透明背景和项目落盘，并规定输出路径与检查流程，核心任务价值明确；但生成结果质量、文本准确性和迭代效果没有静态可验证证据，仍需人工复核，因此扣1分。
SKILL.md、参考文档和CLI源码提供了可审计的规则、参数及错误信息，部分主张可由源码复核；但缺少提交测试、CI覆盖或第三方运行记录，无法支持更高静态分数。
- 核心图像生成依赖外部模型服务；提示词和输入图像的数据处理、保留及隐私边界未在技能文档中明确说明。
- CLI模式需要OPENAI_API_KEY、Python依赖和网络访问；中国大陆用户可能遇到服务可达性或网络审批问题。
- 源码未提供覆盖关键路径的测试或CI证据，生成质量、文字准确性、透明背景边缘和编辑不变量必须人工验证。
它能做什么 & 适用场景
这是一个面向 Codex 的图像生成与编辑技能，专注于照片、插画、纹理、精灵图、产品模型图和透明背景素材等位图输出。默认使用内置 image_gen 工具，不需要 OPENAI_API_KEY；只有明确选择 CLI 回退模式时才需要 API 密钥及相关依赖。它支持单张图像、参考图生成、现有图像编辑以及多资产变体工作流。该技能不适合需要 SVG、矢量图标、HTML/CSS、canvas 或其他确定性代码原生输出的任务。
根据文字提示生成新的位图图像；使用对话中可见的图像进行编辑；读取本地编辑目标前先通过 view_image 检查；为透明背景请求生成纯色抠图背景，再使用本地 remove_chroma_key.py 工具生成带 alpha 的 PNG/WebP；在 CLI 回退模式下运行 scripts/image_gen.py 的 generate、edit 或 generate-batch 子命令；检查生成结果并按单一目标变化迭代。
- 网站或产品团队需要生成 landing page hero、产品展示图或营销素材时。
- 游戏开发者需要制作概念图、精灵图或其他项目位图资产时。
- 设计师需要基于参考图生成风格或构图变体时。
- 用户需要替换背景、移除对象、调整光照或天气而保留图像其他部分时。
- 团队需要制作 UI 模型图、线框图、信息图或科学教育视觉素材时。
优缺点一览
- 覆盖生成、编辑、参考图变体、批量资产和透明背景处理。
- 默认内置工具不需要 OPENAI_API_KEY。
- 包含提示词结构、用例分类、编辑不变量和结果校验指导。
- 明确区分位图生成与 SVG、HTML/CSS、canvas 等代码原生工作流。
- 技能包含较多 Codex 专用工具、路径和环境约定，移植到其他客户端需要调整。
- CLI 回退模式需要 OPENAI_API_KEY、Python、openai 包和 Pillow。
- 复杂透明对象如毛发、烟雾、玻璃、液体或反光材质需要用户确认真正的透明度回退方案。
- 源码未记录独立技能安装器、测试覆盖或跨平台验证情况。
如何安装
该仓库将此技能作为 20 个技能之一，路径为 codex-rs/skills/src/assets/samples/imagegen/SKILL.md。README 只记录 Codex CLI 的安装方式，不提供该技能的独立安装命令。可按仓库说明安装 Codex CLI：macOS/Linux 使用 curl -fsSL https://chatgpt.com/codex/install.sh | sh；Windows 使用 powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"；也可使用 npm install -g @openai/codex 或 brew install --cask codex。
如何使用
在 Codex 中提出明确的图像任务，例如：“生成一张用于网站首页的极简陶瓷咖啡杯产品图，采用干净的产品摄影风格，保留可放置文案的留白，不要 logo、文字或水印。”普通生成和编辑默认使用内置 image_gen。若明确要求 CLI/API/模型路径，再使用 scripts/image_gen.py；CLI 回退需要设置 OPENAI_API_KEY。