SuperAPI AI 工具集

imagegen

设计与创作

查看项目

更新于 10-16 08:01

技能介绍

用途:借 Codex agent 内置的图像生成能力出图,本 Skill 只负责五件事——把需求翻成提示词、把命令跑通、验收、压缩、放进项目该在的目录。图像生成不是 CLI 子命令(没有 codex image),而是 Codex agent 的内置工具 image_gen,因此不要靠翻 codex --help 找 flag 就下结论说不能生图。适用场景包括生成图片、配图、插图、logo、吉祥物、封面、海报、og 图、favicon 源图、真人场景图,以及建站时页面缺图或仍有占位图的情况。

主要能力:把用户需求转成结构化提示词(输出目录绝对路径、逐张编号与精确文件名和尺寸、共享风格块与 hex 调色板、禁止文字水印、无法生成时如实说明的逃生口、逐文件回报要求),执行 codex exec 生成,做接触印相、alpha 包围盒占比、独立盲评三道验收,再按用途压缩为 JPEG/WebP 并落盘到项目目录。一套图共享风格块以保持一致,提示词可默认用目标语言,但真正有效的是把视觉约束写成数字(如头身比、线宽、留白占比)。

使用方式:先 mkdir -p <outdir>,再用 cat <outdir>/prompt.md | codex exec --skip-git-repo-check --config model_reasoning_effort="medium" --sandbox danger-full-access -C <outdir> -o <outdir>/final.md 2>/dev/null 启动;后台跑用 Bash 的 run_in_background: true,且必须从主线程调用,不要从 subagent 内调用(subagent park 后会被判定空闲终止,通知送不到)。生图要走网络,--sandbox danger-full-access 是否需要确认取决于机器授权设置,启动行需说明所用 sandbox。原始输出落在 ~/.codex/generated_images/<session-id>/exec-*.png,输出目录里是后处理过的版本。压缩落盘常用 sips -s format jpeg -s formatOptions 82、cwebp -q 82、sips -Z 512、sips -z 630 1200,透明或占比不达标时用 ImageMagick(magick)二次处理。多文件循环与等待轮询建议用 python3 heredoc 驱动。

限制:Codex 若生成了文字几乎必花,提示词应禁止文字,文字后期用 HTML/CSS 叠;模型未必支持精确像素,需本地缩放;透明背景可能第一版被烤成底色,提示词需写 true alpha, not a white/dark square 并在最终报告出来前不要量图;吉祥物主体占比可能不达标,需用 -trim 后按目标占比 -resize 再 -extent 修正;未压缩的多 MB 原图不得进仓库;og:image 每页独立且不得全站共用一张;不得使用占位图、ASCII art、纯色块或网络下载图代替。codex --version 失败或启动即退出时先 codex doctor 并如实报告,不要盲目重试。