# Document Illustrator

基于文档内容自动生成配图。AI 智能分析文档结构，归纳核心要点， 为每个主题生成符合特定风格的配图。支持封面图生成和自定义图片比例。...

- Repository: https://github.com/op7418/Document-illustrator-skill (607 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-01-21
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add op7418/Document-illustrator-skill --skill document-illustrator -g -a claude-code -y`
Codex: `npx skills add op7418/Document-illustrator-skill --skill document-illustrator -g -a codex -y`
Cursor: `npx skills add op7418/Document-illustrator-skill --skill document-illustrator -g -a cursor -y`
Gemini CLI: `npx skills add op7418/Document-illustrator-skill --skill document-illustrator -g -a gemini-cli -y`

## Description

基于文档内容自动生成配图。AI 智能分析文档结构，归纳核心要点， 为每个主题生成符合特定风格的配图。支持封面图生成和自定义图片比例。 使用场景：当用户需要为文档、文章、笔记生成配图时。 关键词：配图、插图、illustration、generate images、document images

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Document Illustrator Skill

基于 AI 智能分析的文档配图生成工具。无需依赖特定格式，自动理解内容并生成专业配图。

## 🎯 核心特点

- ✨ **AI 智能归纳**：自动理解文档内容，智能提取核心主题
- 🎨 **格式无关**：支持任何格式的文档（Markdown、纯文本、PDF 等）
- 📐 **灵活比例**：支持 16:9（横屏）和 3:4（竖屏）
- 🖼️ **封面图可选**：可生成概括全文的封面图
- 🎭 **三种风格**：渐变玻璃卡片、票据风格、矢量插画

## 🚀 使用方法

### 直接告诉 Claude

```
帮我为这个文档生成配图：/path/to/document.md
```

或者：

```
我想为这篇文章生成一些配图
```

## 📝 完整工作流程

### 第 1 步：Claude 读取和理解文档

当你请求生成配图时，Claude 会：
1. 使用 Read 工具读取完整文档
2. AI 分析理解文档内容和结构
3. 识别核心主题和要点

**无需担心文档格式**：
- ✅ 标准 Markdown（##、###）
- ✅ 分隔线格式（======、------）
- ✅ 纯文本段落
- ✅ 任何其他格式

### 第 2 步：配置选项（3 个问题）

Claude 会询问你的偏好：

#### 问题 1：图片比例
```
请选择图片比例：
1. 16:9 (横屏) - 适合演示文稿、幻灯片、横屏展示
2. 3:4 (竖屏) - 适合社交媒体、手机查看、海报

请选择 (1/2):
```

#### 问题 2：封面图
```
是否生成封面图？
封面图将概括文档的所有核心信息，作为系列配图的引导。

1. 是 - 生成封面图 + 内容配图
2. 否 - 仅生成内容配图

请选择 (1/2):
```

#### 问题 3：内容配图数量
```
期望生成多少张内容配图？
建议范围：3-10 张
根据文档内容，推荐生成 6 张

请输入数字：
```

### 第 3 步：Claude 归纳内容并展示

根据你指定的数量，Claude 会智能归纳文档，然后展示给你确认：

```
📋 内容归纳完成

📄 封面图内容：（如果选择生成）
"AI 编程工具概念演化：从 Rules 到 Skills"
- 核心概念：静态上下文 vs 动态上下文
- 演化路径：Rules → Commands → MCP → Modes → Skills
- 最佳实践：简化为两个核心工具

📚 内容配图（共 6 张）：

1. Rules 的诞生与演化
   包含：早期模型幻觉问题、rules 文件的作用、静态上下文概念

2. Commands 和工作流打包
   包含：固定工作流的出现、slash command、团队分享

3. MCP Servers 带来动态能力
   包含：第三方工具集成、OAuth 认证、上下文膨胀问题

4. Modes 和 Subagents 的登场
   包含：人设提示词、系统提示词修改、可靠性设计、Hooks 确定性

5. Skills 统一动态上下文
   包含：Skills 概念、动态加载、编程工具优化

6. 最佳实践与未来展望
   包含：Rules 使用建议、Skills 探索、核心理念总结

✓ 所有内容已覆盖，无遗漏

确认开始生成配图吗？(Y/N)
```

**关键保证**：
- ✅ 内容完整：所有重要信息都会被归入某张图片
- ✅ 逻辑清晰：按照内容的自然逻辑分段
- ✅ 用户可控：展示归纳结果，等待用户确认

### 第 4 步：生成配图

确认后，Claude 调用 Python 脚本生成图片：

```
🖼️  开始生成配图...

正在生成封面图...
  ✓ 已保存: /path/to/document/images/cover.png

正在生成第 1/6 张...
  标题: Rules 的诞生与演化
  ✓ 已保存: /path/to/document/images/illustration-01.png

正在生成第 2/6 张...
  标题: Commands 和工作流打包
  ✓ 已保存: /path/to/document/images/illustration-02.png

...

✨ 完成！共生成 7 张配图（1 张封面 + 6 张内容）
```

### 第 5 步：输出结果

**输出位置**：文档所在目录下的 `images/` 文件夹

The rest: https://github.com/op7418/Document-illustrator-skill/blob/HEAD//SKILL.md