qiaomu-codex-imagegen Skill 技能

技能简介

qiaomu-codex-imagegen（乔木 Codex 生图）是一款多接入方式的 Agent 生图技能，把 OpenAI Codex CLI 内置的图片生成能力通过 MCP、CLI、Agent Skill 三种方式接出来，让 Claude Code、Cursor、Codex 或任何能跑命令的 Agent 都能通过一句话生成小红书封面、视频封面、公众号头图、电影海报等设计感图片。内置 24 类场景模板（含 48 个预设）、20 位 Mondo 海报设计师风格，以及 689 条公开提示词参考语料，先给方案再出图的工作流确保每张图都有机制不同的方向可选择，杜绝 AI 生图的同质化和失败返工。

核心能力

1. 三模接入：同时提供 MCP 服务、CLI 命令行、Agent Skill 三种使用方式，Claude Code / Cursor / Codex / 任意 LLM Agent 都能直接对接。
2. 24 类场景模板：覆盖巨字与微小叙事、物象破框、中央光隙、东方水墨、纸雕地貌、民艺撞色、童画、花境拼贴、棚拍与环境与婚礼肖像、食品与饮品近摄、植物手绘产品、科技轨道、巨物微缩剧场、建筑制图、框景、文博材质、会议名录、九宫格、演示、科普信息卡、日签等全场景。
3. 先方案后出图：第一步 suggest_directions 免费给出至少 4 个机制不同的方向，附参考案例缩略图和需要补充的信息，避免直接生成失败。
4. 完整提示词工程：compose_prompt 把模板展开为成品提示词，附避免项、验收条件、缺失信息提示、风格锁等约束，确保生成结果可预测。
5. 20 位 Mondo 设计师风格：集成 Olly Moss、Saul Bass、Martin Ansin、Tyler Stout、Kilian Eng、Drew Struzan 等 20 位经典海报设计师的视觉语言。
6. 图生图编辑：通过 --ref 传入参考图，可实现「保持主体不变、只换背景」等精修场景。
7. 本地参考语料：内置 689 条公开提示词的检索接口（需用户自行构建本地数据包），search_prompts 可查相似案例。
8. 自动验收：Agent 出图后会对着验收条件逐条检查，不合格仅改对应句重生成，避免反复全量重抽。

安装配置

1. 环境要求：Node.js 18+、已登录的 OpenAI Codex CLI（确保 Codex 账号可使用图片生成）。
2. 作为 Skill 安装（最简单）：npx skills add joeseesun/qiaomu-codex-imagegen，Agent 即可识别场景、风格、提示词编写规则并自动调用。
3. 注册 MCP 服务：Claude Code 执行 claude mcp add --scope user qiaomu-codex-imagegen -- node /绝对路径/qiaomu-codex-imagegen/scripts/mcp-server.mjs，提供 suggest_directions / compose_prompt / generate_image / search_prompts 等 7 个工具。

使用步骤

1. 通过 npx skills add 或 MCP 注册安装本技能到目标 Agent。
2. 用自然语言对 Agent 描述需求：「给这期视频做一张 16:9 封面，要有设计感，先出三个方案」。
3. Agent 调用 suggest_directions 给出至少 4 个机制不同的方向（文字主导、平面结构、摄影人物、产品近摄、Mondo 设计师等），每个方向附风格锁和需要补充的信息。
4. 用户选定一个或多个方向（或直接说「你定」）。
5. Agent 调用 compose_prompt 把选定模板展开成完整提示词（含避免项、验收条件、缺失信息）。
6. Agent 调用 generate_image 出图，图旁写 JSON 记录实际提示词，便于复现和做系列。
7. Agent 对照验收条件逐条检查结果，不合格时仅重做对应一句提示词后重新生成。

适用场景

1. 小红书/抖音/B 站封面图：内置 xiaohongshu / video-cover / video-vertical 等预设，比例 3:4 / 16:9 / 9:16 一键出图。
2. 公众号头图 / 朋友圈海报 / X 封面：覆盖 wechat-cover 2.35:1、moments 4:5、x-cover 5:2 等常见社媒比例。
3. 电影海报 / 书籍封面 / 专辑封面：含 poster / movie-poster / book-cover / album-cover 等专用预设。
4. 图生图改图：上传铅笔原图，提示「保持同一支铅笔，背景换成暖米色纸张」即可生成改后图。
5. 设计灵感和方案探索：通过 suggest_directions 探索多种机制方向，避免在错误方向上反复试错。
6. 内容创作者的批量出图：通过模板+预设保持系列图风格一致，适合公众号、播客、YouTube 频道做整套视觉资产。

适用人群

• 小红书 / 公众号 / YouTube 内容创作者
• 独立设计师与品牌工作室（需要快速出方案）
• AI Agent 开发者（想给 Agent 增加生图能力）
• 营销团队（需要批量产出海报素材）
• 出版 / 影视行业前期概念图

工作原理

整个工具链以 Codex CLI 的内置图片生成能力为核心，向上叠加三层抽象：1) 场景预设层（xiaohongshu、video-cover 等）规定比例和安全区构图规则；2) 设计系统层（24 类模板 + 48 个预设）通过 references/design-system 目录定义风格锁、变量、失败条件、验收项；3) 风格层（66 种通用风格 + 20 位 Mondo 设计师）提供视觉语言选择。调用顺序严格遵循「先 recommend 方向 → 用户选定 → compose 提示词 → generate 出图 → verify 验收」五步走，每个方向都强制要求机制不同（不允许仅换颜色滤镜），并对生成结果做"关系比物品稳定、颜色按角色替换、文字也是形体"等方法论验收。

官方链接

• GitHub 仓库：https://github.com/joeseesun/qiaomu-codex-imagegen
• MCP 配置文档：仓库内 scripts/mcp-server.mjs
• 设计系统参考：仓库内 references/design-system/
• Mondo 设计师风格指南：仓库内 references/mondo-poster.md
• 许可证：MIT License