tao-hpu/tao-md-image-gen

MD 配图自动生成

为 Markdown 文章生成配图并替换为实际图片引用。

前置依赖：本 skill 依赖 mcp-image MCP server。 如未安装，请先运行：claude mcp add mcp-image -s user -- npx -y mcp-image 并配置环境变量 GEMINI_API_KEY（或对应的图片生成服务 key）。

使用方式

/tao-md-image-gen <md-file-path>

Step 0: 环境检查

在开始前，先确认 mcp__mcp-image__generate_image 工具可用。 如果不可用，提示用户：

此 skill 依赖 mcp-image MCP server，当前未检测到该工具。
请先安装：claude mcp add mcp-image -s user -- npx -y mcp-image
并设置环境变量 GEMINI_API_KEY。

然后停止执行。

Step 1: 读取 MD 文件

用 Read 读取用户指定的 MD 文件。如果文件不存在，提示检查路径后停止。

Step 2: 判断模式

扫描文件内容，查找 生成提示： 或 生成提示: 标记。

• 找到 → 进入 模式 A：批量生成并替换
• 未找到 → 进入 模式 B：分析文章建议配图

---

模式 A：批量生成并替换

A1: 提取配图块

识别所有配图块。配图块的常见结构：

**封面图**
- 描述：[简要描述]
- 图注：[图片说明]
- 生成提示：[English prompt]

**配图**
- 描述：[简要描述]
- 图注：[图片说明]
- 生成提示：[English prompt]

也兼容变体格式（无描述行、无图注行、只有生成提示行等）。 核心匹配：以 生成提示： 或 生成提示: 开头的行，向上关联最近的 **封面图** / **配图** 标题和其他元数据行。

从每个配图块提取：

• prompt：生成提示： 后的完整文本
• caption：图注： 后的文本（可能没有）
• type：封面图 / 配图

A2: 直接全部生成（无需确认）

跳过确认步骤，直接生成所有找到的配图。不要向用户询问"全部生成？"，直接开始生成。

A3: 逐个生成

对每张确认的图片：

1. 解析 aspect ratio：从 prompt 中提取 Aspect ratio 16:9 → "16:9"。 未指定时：封面图默认 "16:9"，配图默认 "4:3"。

2. 文件名：封面图 → cover，配图按序号 → fig1、fig2...

3. 调用 MCP：

   mcp__mcp-image__generate_image(
     prompt: [英文 prompt，去掉末尾的 "Aspect ratio X:Y" 部分],
     aspectRatio: [解析的比例],
     fileName: [文件名]
   )
   

4. 移动图片到 MD 文件所在目录： MCP 默认将图片保存到其配置的输出目录（如 /Users/TaoTao/Pictures/nano-banana/）。 注意：MCP 生成的文件可能没有 .png 扩展名，移动时需要加上。 生成后，用 Bash 将图片移动到 MD 文件所在目录的 images/ 子目录下：

   mkdir -p /path/to/md-dir/images
   # 注意：源文件可能没有扩展名，目标文件需要加 .png
   mv /Users/TaoTao/Pictures/nano-banana/cover /path/to/md-dir/images/cover.png
   

   其中 /path/to/md-dir 是 MD 文件所在的目录。如果源文件带 .png 扩展名则直接移动。

5. 记录最终图片路径。如果生成或移动失败，记录错误，跳过继续。

A4: 替换 MD 内容

用 Edit 工具将每个配图块替换为图片引用。

替换前：

**配图**
- 描述：问题或现象的可视化描述
- 图注：AI 代写让努力变隐形（图片由安涛在 Nano Banana 生成）
- 生成提示：Pixel art showing invisible effort. 8-bit style, blue and white palette.

替换后：

![AI 代写让努力变隐形](images/fig1.png)
*AI 代写让努力变隐形（图片由安涛在 Nano Banana 生成）*

替换规则：

• 图片路径使用相对路径 images/文件名.png，确保 MD 文件可以正确引用
• 整个配图块（从 **封面图**/**配图** 到生成提示行）替换为 ![caption](path) + 斜体 caption
• 如果没有图注，用描述作 alt text，不加斜体 caption 行
• 如果都没有，用 ![图片](path) 兜底
• 不要改动 MD 文件的其他任何内容

A5: 输出结果

完成！生成了 N 张图片：
- images/cover.png → 封面图
- images/fig1.png → [描述]
- images/fig2.png → [描述]

图片保存在：[MD文件所在目录]/images/
已更新 MD 文件中的图片引用（相对路径）。

如有失败的，列出失败原因。

---

模式 B：分析文章建议配图

当文章中没有 生成提示 时，分析文章内容，给出配图建议。

B1: 分析文章结构

阅读全文，识别：

• 文章主题和风格
• 各章节的核心内容
• 适合插图的位置（通常在章节开头、核心论点、对比说明处）

B2: 输出建议

以建议形式输出，不自动生成：

该文章未包含配图 prompt。基于文章内容，建议在以下位置添加配图：

1. [封面图] 建议位置：文章开头
   参考 prompt：Pixel art editorial illustration for [topic]. 8-bit retro game style, clean geometric shapes. Color palette: primary blue (#0052FF) and white. Aspect ratio 16:9.

2. [配图] 建议位置：「## 第二节标题」之后
   参考 prompt：Pixel art diagram showing [content]. 8-bit style, blue (#0052FF) and white palette. Aspect ratio 4:3.

3. [配图] 建议位置：「## 第三节标题」之后
   参考 prompt：Pixel art comparison of [A] vs [B]. 8-bit style, blue (#0052FF) and white palette. Aspect ratio 4:3.

如需使用，请将上述 prompt 添加到 MD 文件对应位置，然后重新运行 /tao-md-image-gen。
或者直接告诉我"用这些 prompt 生成"，我来帮你插入并生成。

注意：

• 参考 prompt 只是示例，风格参照文章已有的风格线索（如果有的话）
• 如果文章没有风格线索，用通用的像素风格作为默认建议
• 建议数量：短文 2-3 张，长文 3-5 张
• 直接将建议的 prompt 插入文件并生成图片，无需等待用户确认

---

配置说明

本 skill 的图片生成完全依赖 mcp-image MCP server。

查看当前配置：

claude mcp get mcp-image

修改配置（如更换 API key 或模型）：

claude mcp remove mcp-image -s user
claude mcp add mcp-image -s user -e GEMINI_API_KEY=your-key -e IMAGE_OUTPUT_DIR=/your/path -- npx -y mcp-image