qiaomu-codex-imagegen Skill：让任意 Agent 调用 Codex 内置生图

Skill超级捕获手 技术创作者 2026-10-09 278 阅读

让任意 Agent 调用 Codex 内置生图：qiaomu-codex-imagegen 深度解读

OpenAI Codex 的内置生图能力目前在业内公认质量顶级，但长期只能通过 Codex CLI 本身调用，无法被其他 Agent 工具使用。qiaomu-codex-imagegen 打破了这个壁垒——以 Skill + MCP Server + CLI 三合一形态，将 Codex 生图能力以标准化接口开放给任意 Agent，让 Claude Code、Cursor、豆包、Deepseek Harness 等主流工具都能直接出图制作封面与信息图。该项目 10 月 4 日发布，一周内斩获 110+ GitHub Star，且仍处于活跃迭代中。

功能与原则

qiaomu-codex-imagegen 核心是一个 MCP Server，同时以 Skill 和 CLI 形态发布，三者共用同一套生图逻辑。设计上遵循”先构思再生成”原则：Agent 下达”做一张封面”指令时，不会直接出图，而是先由 suggest_directions 给出至少四个机制各异的风格方向供选择，用户或 Agent 确认后再由 compose_prompt 展开完整提示词、生成并自检。这种两阶段流程有效控制了生图随机性，避免 AI 反复出图浪费额度。

认可度

  • GitHub Star：110+（截至 2026-10-09，发布约 5 天）
  • 发布节奏：10 月 4 日 v0.2.0，10 月 4 日同天 v0.3.0，两次 release 说明仍在密集迭代
  • 社媒热度：在 AITOP、AI热报、AGI Hunt 等多个 AI 资讯平台被专题报道；MCP Toplist 排名全球 MCP Server 前 5%（#4,879 / 143,197）
  • 注册量：MCP Toplist 追踪到 2 个 release tag，实际安装量预估更高

链接

GitHub：https://github.com/joeseesun/qiaomu-codex-imagegen

原作者

joeseesun（向阳乔木），专注 AI 编程工具与 Skill 开发的独立开发者，已发布 5 个 MCP Server，qiaomu 系列 Skill 在社区有较高知名度。此前的 qiaomu-seo、qiaomu-design 均已获得数千 Star 与广泛使用。

介绍

qiaomu-codex-imagegen 将 OpenAI Codex CLI 内置的 DALL-E / 4o 图片生成能力以标准化 MCP 协议开放出来。在此之前，Agent 若想生成一张封面图，需要人工介入切换到 Codex 界面操作后，再把图片传回。整个流程割裂，且无法在纯 Agent 工作流中自动化。

该 Skill 内置了一套从提示词工程实践中提炼的方法论：24 类场景模板（小红书、YouTube 封面、海报、书封、信息图等）、20 位 Mondo 海报设计师风格选项，以及防止 AI 乱写文字、编造事实的规则体系。Agent 调用时，系统会引导其先选择方向和模板，再生成，这样产出的图片文字准确、风格统一、废片率低。

除 MCP Server 外，该项目还提供 Skill 格式（npx skills add）安装，以及纯 CLI 模式，满足不同技术背景用户的接入需求。

特点

  • 三合一接入：Skill / MCP Server / CLI，任选一种方式接入，核心能力完全相同
  • 先构思后生成：内置 suggest_directions + compose_prompt 两步流程，控制随机性，提升出图质量
  • 内置方法论：24 个场景模板、20 种 Mondo 设计师风格、提示词防错规则，无需用户自行设计提示词工程
  • 零成本预览方向：suggest_directions 不消耗生图额度，免费给出风格建议后才决定是否生成
  • 跨 Agent 通用：支持 Claude Code、Cursor、豆包、Deepseek Harness、Codex 等所有能调用 MCP 或执行命令的 Agent
  • 多格式返回：生成后返回文件路径、像素尺寸、所使用提示词，并附带 JSON 元数据，方便 Agent 自动化处理

使用方法

前置条件：Node.js 18+、已安装并登录的 Codex CLI（codex --version 能正常运行）、Codex 账号已开通图片生成功能。

方式一：作为 Skill 安装（推荐，任意 Agent 通用）

npx skills add joeseesun/qiaomu-codex-imagegen

方式二：注册 MCP Server（推荐 Claude Code 用户）

claude mcp add --scope user qiaomu-codex-imagegen -- node /绝对路径/qiaomu-codex-imagegen/scripts/mcp-server.mjs

其他 MCP 客户端（Cursor、Codex 等）在配置中加入：

{
  "mcpServers": {
    "qiaomu-codex-imagegen": {
      "command": "node",
      "args": ["/绝对路径/qiaomu-codex-imagegen/scripts/mcp-server.mjs"]
    }
  }
}

方式三：纯 CLI

git clone https://github.com/joeseesun/qiaomu-codex-imagegen
cd qiaomu-codex-imagegen
node scripts/mcp-server.mjs --help

MCP Server 提供七个工具：

工具 作用
suggest_directions 给出 ≥4 个机制各异的风格方向（免费，即时）
compose_prompt 把模板和预设展开为完整提示词，附避免项与验收条件
generate_image 生成或改图，返回路径、尺寸、提示词、JSON 元数据
search_prompts / get_prompt 检索本地参考提示词语料
build_prompt 简易路线的提示词预览，不消耗额度
list_catalog 列出全部场景预设、模板、风格键状态

使用场景与人群

适用场景：小红书配图与信息图制作、YouTube 视频封面、社交媒体海报、书籍/专辑封面、产品宣传图、任意需要 AI 生成图像的内容创作工作流。

目标用户：使用 Claude Code、Cursor 等 Agent 工具进行自动化工作的开发者；在内容创作流程中需要 AI 生图能力的内容团队；希望将 Codex 生图能力整合进自己产品或工作流的独立开发者和创作者。

输入与输出案例

案例一：生成小红书封面

Agent 输入："帮我做一张小红书封面，主题是'AI 编程效率翻倍'，科技感风格"
↓ suggest_directions 返回：文字主导、平面结构、摄影人物、产品近摄、Mondo 设计师等方向
↓ Agent 选择"产品近摄 + 科技感"
↓ compose_prompt 展开为完整英文提示词
↓ generate_image 生成图片
↓ 返回路径 + 尺寸 + JSON 元数据
最终产出一张 1024×1024px 科技风小红书封面图，文字无错误

案例二：Agent 工作流中嵌入生图

Agent 正在写一篇技术博客，需要一张配图
Agent 调用 suggest_directions → 获取 4 个风格方向
Agent 选择"信息图风格"
Agent 调用 compose_prompt → 获取完整提示词
Agent 调用 generate_image → 生成 1024×768px 信息图
图片路径写入文章 Markdown，自动化完成配图工作

GitHub: https://github.com/joeseesun/qiaomu-codex-imagegen

评论区

0 条评论

登录后可评论。

Skill超级捕获手 278 阅读