| name | wenqu-image |
| description | 为内容设计并生成、质检、上传、嵌入架构图、流程图、信息图和示意图，覆盖提示词设计到 最终出图。当用户要求“画个架构图”“画流程图”“生成配图”“生成图片”“把图画出来” “渲染一下”或“帮我生图”，或使用 "draw an architecture diagram", "generate an image", "create a flowchart" 等英文表达时使用。 |
| slug | wenqu-image |
| displayName | 文曲·配图 |
| version | 0.1.19 |
| summary | 为内容生成 AI 配图（架构图/流程图/信息图/示意图）：提示词、生图、质检、上传全流程。 |
| license | MIT |
| homepage | https://github.com/gogoingai/wenqu-skills |
| metadata | {"openclaw":{"homepage":"https://github.com/gogoingai/wenqu-skills/tree/master/wenqu-image"}} |
内容配图与生图 Skill
📦 项目仓库与源码：https://github.com/gogoingai/wenqu-skills
与调用方的接口约定
其他写作技能（如 wenqu-write）在正文里为图片预留位置时，用两种标记之一：
| 标记 | 含义 | 谁来写 |
|---|
> 🖼️ 待配图：[一句话描述这张图要表达的核心内容] | 占位标记，只知道这里需要一张图，还没想好具体画法 | 调用方（写作阶段） |
```（代码块）第一行 # 画图提示：[描述] | 完整画图提示，规范已写全，可以直接生成 | 本技能，或调用方已自行写好 |
本技能被调用时，先把占位标记转换成完整画图提示，再进入生成流程——两步不能合并，写法未确认前不要直接生成。
完整画图提示必须带风格 YAML frontmatter，格式是 # 画图提示 代码块内、提示正文之前加一段 YAML，风格、参考图路径、版本记录都写进提示本身，不能只存在对话记忆里——不然下次改图或复现时，所用风格、参考图与版本记录都无从解析：
style: 单色马克笔 # 对应风格库表里的风格名；无风格关键词时写"默认极简PPT"
ref: mono-marker/mono-marker-02-branch-decision.png # 实际用过的参考图：styles/ 下的相对路径（不含域名），由 wenqu image fetch-ref 解析为受管缓存路径；临时本地路径不得写入；本轮没用 --ref 时保持原值不动；该字段从未用过时才省略
versions: # 历次生成的版本记录；每项必须是 HTTPS CDN URL，含质检不通过/用户否决版本，编号递增，不删除、不覆盖
v1: https://cdn.example.com/article-img-1111aaaa2222bbbb.png # 简要说明
generation: # 与 versions 同编号，记录实际渲染后端；不存密钥或 API 地址
v1:
provider: codex
model: codex-image-gen
画图提示：[图片标题]
...（提示正文，四条核心原则见下方）
转换占位标记、或用户直接给风格关键词时，都按这个格式写；references/styles/*.md 里该风格追加的专属描述句，直接拼进提示正文，不要另起一段脱离 YAML 之外的"风格说明"，避免以后只读提示正文时丢失风格信息。每次实际传入 --ref 后，把这次真正生效的参考来源回填进 ref 字段：风格资产用 GitHub raw URL，已采用图片用 HTTPS CDN URL；命令中临时使用的 /tmp 文件不得回填。ref 记的是“这次生成实际参考了什么”，不是“这个风格理论上可以参考什么”；没用 --ref 的这一轮，不要动 ref: 字段，保留上一次的记录。只有上传成功、拿到 HTTPS CDN URL 的版本才可写入 versions，同时把本次实际 provider/model 写入同编号 generation；正文的 ![]() 只指向当前采用的那一版，其余版本仅留存在 versions 里供回看对比，具体写入规则见 references/gen-workflow.md 第四步。
用户输入工具
当本技能需要用户确认选择、补充必要信息或授权有副作用的操作时：
- 优先使用当前运行时提供的原生用户输入工具，例如
AskUserQuestion、request_user_input、clarify、ask_user 或等价能力。
- 若没有此类工具，使用带编号或字母选项的文本问答。
