mcpField
C
codex-imagegen

codex-imagegen

github.com/junseo99创意与媒体15108 次安装7 周前更新
代码仓库

关于 codex-imagegen

一项通过已登录的 Codex CLI 处理图像生成请求的技能，由 Claude 负责引导和审阅。它涵盖生成、编辑、检查和交付流程，并要求使用用户的 Codex 订阅。

主要功能

  1. 01按请求意图选择流程
  2. 02整理结构化图像简报
  3. 03通过 Codex CLI 生成和编辑图像
  4. 04检查任务状态与输出图像
  5. 05验证透明度和尺寸

适用场景

  1. 01根据明确简报生成图像
  2. 02制作多个不同的图像方向
  3. 03编辑现有图像并保留指定细节
  4. 04交付前检查生成图像

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/junseo99/claude-skill-codex-imagegen --skill codex-imagegen

安装后在 Claude Code 中输入/codex-imagegen确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
cli-reference.md
directions.md
editing.md
interview.md
prompting-guide.md
scripts/
image_project.py
run_codex_imagegen.py
verify_png_alpha.py

详细介绍

Codex Imagegen

Claude 负责指导和审阅；Codex 只负责生成。使用用户的 Codex 订阅； 绝不使用单独计费的图像 API。需要 Python 3.9+、macOS/Linux，以及 已登录的 Codex CLI 0.153.4+（codex login）。从此文件中解析 <SKILL_DIR>。

根据意图选择路径

请求操作仅在需要时阅读
明确的请求 /“直接生成”立即生成一张图像无需额外参考
方向不明确 /“采访我”一起提出 1–3 个关键问题interview.md
“选项”、“시안”、多个方向如果未指定数量，默认提供 3 个不同候选方案directions.md
修改现有图像检查图像，说明修改内容和保留清单，并附上图像editing.md
精确文本、摄影、复杂构图只补充相关的创作细节prompting-guide.md
模型问题或执行失败说明已验证的能力或修复故障cli-reference.md

不要加载所有参考资料、仓库文档或启动器源代码。复用上下文中已有的回答和相关项目风格信息。只有在需要匹配本项目风格时才阅读 DESIGN.md。不要运行 Codex 来进行访谈、规划或评判。

编写创作简报

使用用户的语言。仅在会影响图像时，说明用途、主体、媒介、构图、光线、 配色和限制条件。保留用户的详细要求；省略不相关的字段。普通图像的简报以 80–180 词为宜， 局部编辑则更短；精确文案和必要的保留规则优先。

$imagegen
Asset: website hero, landscape 16:9, one image
Request: a handmade terracotta cup on pale limestone
Look: editorial product photograph; soft window light from the left;
matte glaze, natural surface imperfections; warm ivory and rust palette
Composition: cup in the right third; quiet empty left half for page copy
Constraints: no text, watermark, border, or extra objects

引用精确文本，并注明其位置及仅出现一次。对于参考图，按附件顺序添加 Image 1: base to edit; Image 2: material reference only。 只向 Codex 发送最终简报和必要图像，绝不发送对话内容、 访谈回答、研究资料、本技能或整份设计文档。

生成和检查

使用主机的文件写入工具编写 UTF-8 格式的简报，然后在后台启动：

python3 "<SKILL_DIR>/scripts/image_project.py" --prompt-file "<BRIEF>" --out-dir "<NEW_DIR>" --background
# Attach inputs with --image "<BASE.png>" (repeat in reference order).

此操作会立即返回一个作业目录。继续处理其他独立的请求； 稍后使用 image_project.py --out-dir "<DIR>" --status 检查状态（无需调用 Codex）。 不要反复轮询，也不要在状态为排队中或运行中时声称已完成。从清单中读取 已完成文件的路径，然后检查这些文件。如果唯一的工作是生成图像， 请使用主机的后台任务机制等待，并以合理的时间间隔检查状态。 多图计划默认使用两个工作进程（可配置为 1–4 个）；请参阅 directions.md。 底层的 run_codex_imagegen.py 仍可用于前台执行。

启动器默认使用轻量级的 gpt-5.6-luna 中继，推理设置为 none， 中继指令精简，不加载技能目录，并禁用无关工具。 --model 用于选择文本中继，而非图像模型。Flare 更注重速度；Sunburst 更适合高要求的质量和精细编辑。Codex 内置工具负责管理其图像后端，且此启动器无法固定使用的后端。不要声称使用了特定图像模型、API 质量设置、原生 4K 或像素级保真。

只将经过验证的 stdout PNG 路径复制到用户指定的目标位置或 output/imagegen/<purpose>/。保留原图；编辑后的文件使用带版本号的文件名。 使用 Claude 的图像读取工具，以全图视图和相关细节检查图像。 检查是否符合意图、构图、文字准确性、人体结构／产品几何形状、细节保留情况 和边缘。路径有效不代表质量检查通过。指出任何可见且尚未解决的缺陷。

如果用户要求透明背景，请运行：

python3 "<SKILL_DIR>/scripts/verify_png_alpha.py" --require-transparent-corners "<PNG>"

仅对独立抠图使用角落标志。不要把棋盘格像素误认为 Alpha。透明背景编辑请参阅 editing.md。导出前测量实际尺寸；较旧的 0.153.2 基线约为 1.57 MP，并不代表当前分辨率保证。按比例调整大小；有意裁切或填充，切勿拉伸。对放大处理如实标注。

仅生成用户要求的数量。每张被拒绝的图像最多进行一次有针对性的修复；不要自动润色已接受的作品、重试超时任务或重新运行整个图像集。用户要求的修改应作为新的编辑开始。返回预览、可用的文件路径，以及一个实用的下一步建议，例如“选 2 并告诉我需要修改什么。”

评论

支持 Markdown