Skill: antonia-sz/long-article-illustration (version 1.0.0)

--- name: long-article-illustration description: 长文配图助手。为长篇文章自动划分段落、生成AI配图提示词并调用图像生成工具完成配图。适用场景：(1) 公众号/博客长文需要配图 (2) 用户上传文章希望获得段落配图建议 (3) 批量生成文章插图 (4) 用户提到"文章配图""长文插画""段落配图"等关键词时触发 --- # 长文配图助手 为长篇文章自动生成配图，包括智能段落划分、配图提示词生成、图像生成调用。 ## 工作流程 ``` 用户上传长文 → 段落划分 → 提示词生成 → 图像生成 → 输出交付 ``` ## Step 1: 收集输入 向用户确认以下信息： | 参数 | 必填 | 默认值 | 说明 | |------|------|--------|------| | 文章内容 | ✅ | - | 完整文章文本 | | 图片风格 | ❌ | 扁平插画 | 见 `references/style-presets.md` | | 图片比例 | ❌ | 16:9 | 公众号内文建议16:9，封面2.35:1 | | 配图密度 | ❌ | 每2-3段一图 | 可选：每段一图/每小节一图 | ## Step 2: 段落划分 按以下优先级划分： 1. **显式标题**：识别 `#`、`##`、`一、`、`1.` 、`（1）`、`（一）`、`1️⃣`、`①`等标题标记 2. **语义边界**：主题转换、时间跳跃、场景切换 3. **长度均衡**：单个配图覆盖300-600字为宜 输出格式： ``` 【段落1】标题/摘要 正文内容... 【段落2】标题/摘要 正文内容... ``` ## Step 3: 生成配图提示词 为每个需要配图的段落生成提示词，遵循以下结构： ``` [主体描述], [场景/背景], [风格关键词], [技术参数] ``` ### 提示词生成规则 1. **提取核心意象**：从段落中识别最具画面感的元素 2. **避免抽象概念**：将抽象概念转化为具象画面 3. **保持风格一致**：全文配图使用统一的风格关键词，特别是出现了人物或角色的图片，需要保持是同一个人物 4. **添加技术参数**：比例、光线、构图等 5. **不要出现文字**：在提示词中，需要强调最终生成的图片不要包含任何文字 风格预设详见 `references/style-presets.md` ### 示例 段落内容： > 创业初期，我们挤在一间不到20平米的小办公室里，每天工作到深夜... 生成提示词： > A small crowded office space with desks and computers, warm lamplight at night, papers and coffee cups scattered around, flat illustration style, warm color palette, 16:9 ## Step 4: 调用图像生成 根据生成的提示词，调用图像生成模型完成配图。 **支持的生图方式**： - 调用已配置的 AI 生图 API（如 DALL-E、Midjourney、Stable Diffusion 等） - 将提示词复制到在线生图工具手动生成 - 使用本地部署的生图模型 > 💡 用户可根据自身需求选择生图工具，并自行配置对应的 API ## Step 5: 输出交付 ### 输出格式选项 **选项A：Markdown文档（默认）** ```markdown # 文章标题 ![配图1](image1.png) 第一段正文内容... ![配图2](image2.png) 第二段正文内容... ``` **选项B：提示词清单** ```markdown | 段落 | 段落摘要 | 配图提示词 | |------|----------|------------| | 1 | xxx | prompt1 | | 2 | xxx | prompt2 | ``` **选项C：打包下载** - 所有图片文件 - 带图片引用的Markdown文档 - 提示词记录文件 ## 参考资料 - 风格预设与提示词模板：`references/style-presets.md` - 段落划分详细规则：`references/paragraph-rules.md` - 常见问题处理：`references/troubleshooting.md`

path: README.md
content: # 长文配图助手 (Long Article Illustration)

为长篇文章自动生成 AI 配图的 Skill 配置文件。

## ✨ 功能特性

- **智能段落划分**：自动识别文章结构，按语义边界划分配图段落
- **提示词生成**：为每个段落生成高质量的图像生成提示词
- **多风格支持**：扁平插画、水彩、卡通、国风水墨、科技感、极简线条
- **人物一致性**：通过角色锚定描述保持同一人物外观一致
- **避免图片文字**：自动添加参数避免生成的图片出现乱码文字

## 📁 文件结构

```
├── SKILL.md                    # 主配置文件，定义完整工作流程
├── references/
│   ├── style-presets.md        # 6种图片风格预设及提示词模板
│   ├── paragraph-rules.md      # 段落划分详细规则
│   └── troubleshooting.md      # 常见问题处理方案
└── preview/                    # 效果预览案例
    ├── 校园主题文章_配图效果.pdf
    ├── 职场主题文章_配图效果.pdf
    └── 案例*.png
```

## 🚀 使用方法

1. 将 `SKILL.md` 及 `references/` 文件夹导入支持 Skill 的 AI 助手
2. 向 AI 提供需要配图的长文章
3. 可选参数：
   - **图片风格**：默认扁平插画
   - **图片比例**：默认 16:9
   - **配图密度**：默认每 2-3 段一图

## 🎨 支持风格

| 风格 | 适用场景 |
|------|----------|
| 扁平插画 | 科技、商业、教程 |
| 水彩风格 | 情感、文艺、生活 |
| 卡通风格 | 轻松、幽默、儿童 |
| 国风水墨 | 传统文化、古典 |
| 科技感 | AI、数据、未来 |
| 极简线条 | 高端、简约、商务 |

## 📐 支持比例

| 用途 | 比例 |
|------|------|
| 公众号封面 | 2.35:1 |
| 公众号内文 | 16:9 |
| 小红书配图 | 3:4 |
| 正方形 | 1:1 |

## 📸 效果预览

| | |
|:---:|:---:|
| ![案例1](preview/案例1.png) | ![案例2](preview/案例2.png) |
| ![案例3](preview/案例3.png) | ![案例4](preview/案例4.png) |

## 📄 许可证

本项目采用 [MIT 许可证](LICENSE) 开源。


# Long Article Illustration Assistant

An AI Skill configuration for automatically generating illustrations for long-form articles.

## ✨ Features

- **Smart Paragraph Segmentation**: Automatically identifies article structure and divides content by semantic boundaries
- **Prompt Generation**: Creates high-quality image generation prompts for each paragraph
- **Multiple Styles**: Flat illustration, watercolor, cartoon, Chinese ink, tech, minimalist
- **Character Consistency**: Maintains consistent character appearance through anchor descriptions
- **Text-Free Images**: Automatically adds parameters to prevent garbled text in generated images

## 📁 File Structure

```
├── SKILL.md                    # Main config file defining the complete workflow
├── references/
│   ├── style-presets.md        # 6 style presets and prompt templates
│   ├── paragraph-rules.md      # Detailed paragraph segmentation rules
│   └── troubleshooting.md      # Common issue solutions
└── preview/                    # Preview examples
    ├── 校园主题文章_配图效果.pdf   # Campus theme article demo
    ├── 职场主题文章_配图效果.pdf   # Workplace theme article demo
    └── 案例*.png                 # Sample images
```

## 🚀 Usage

1. Import `SKILL.md` and the `references/` folder into an AI assistant that supports Skills
2. Provide the AI with your long-form article
3. Optional parameters:
   - **Image Style**: Default is flat illustration
   - **Aspect Ratio**: Default is 16:9
   - **Illustration Density**: Default is one image per 2-3 paragraphs

## 🎨 Supported Styles

| Style | Best For |
|-------|----------|
| Flat Illustration | Tech, business, tutorials |
| Watercolor | Emotional, literary, lifestyle |
| Cartoon | Casual, humor, children's content |
| Chinese Ink | Traditional culture, classical |
| Tech/Futuristic | AI, data, future topics |
| Minimalist | Premium, simple, business |

## 📐 Supported Aspect Ratios

| Usage | Ratio |
|-------|-------|
| WeChat Article Cover | 2.35:1 |
| WeChat Article Content | 16:9 |
| Xiaohongshu (RED) | 3:4 |
| Square | 1:1 |

## 📸 Preview

| | |
|:---:|:---:|
| ![案例1](preview/案例1.png) | ![案例2](preview/案例2.png) |
| ![案例3](preview/案例3.png) | ![案例4](preview/案例4.png) |

## 📄 License

This project is open source under the [MIT License](LICENSE).


path: references/paragraph-rules.md
content: # 段落划分规则

## 划分原则

### 优先级顺序

1. **显式结构标记**（最高优先级）
2. **语义边界识别**
3. **长度均衡调整**（最低优先级）

---

## 规则详解

### 规则1：显式结构标记

识别以下标题/分隔标记，作为段落边界：

| 标记类型 | 示例 | 处理方式 |
|----------|------|----------|
| Markdown标题 | `#` `##` `###` | 每个标题开启新段落 |
| 数字序号 | `1.` `2.` `（1）` `（一）` `第一章` | 每个序号开启新段落 |
| 中文序号 | `一、` `二、` `首先` `其次` | 每个序号开启新段落 |
| Emoji/特殊序号 | `1️⃣` `2️⃣` `①` `②` `❶` `❷` | 每个序号开启新段落 |
| 分隔线 | `---` `***` `===` | 分隔线前后各为一段 |
| 空行分隔 | 连续2个以上空行 | 视为段落分隔 |

### 规则2：语义边界识别

当无显式标记时，识别以下语义转换点：

| 边界类型 | 识别信号 | 示例 |
|----------|----------|------|
| **时间跳跃** | 时间词变化 | "三年前..." → "如今..." |
| **场景切换** | 地点/环境变化 | "在办公室..." → "回到家后..." |
| **主题转换** | 讨论对象变化 | 从产品功能 → 用户反馈 |
| **视角转换** | 叙述角度变化 | 从个人经历 → 行业观察 |
| **论证层次** | 论点推进 | 提出问题 → 分析原因 → 给出方案 |

**语义边界信号词**：
```
转折：但是、然而、不过、可是、事实上
递进：而且、更重要的是、不仅如此、此外
因果：因此、所以、由此可见、正因为如此
转换：另一方面、与此同时、说到这里、话说回来
总结：总之、综上所述、总的来说、最后
```

### 规则3：长度均衡调整

在前两条规则基础上进行微调：

| 情况 | 处理方式 |
|------|----------|
| 段落过长（>800字） | 在语义次边界处拆分 |
| 段落过短（<150字） | 与相邻段落合并（主题相关时） |
| 配图密度要求 | 根据用户设定的配图密度调整 |

**理想段落长度**：300-600字/段（对应一张配图）

---

## 配图密度策略

| 密度设置 | 说明 | 适用场景 |
|----------|------|----------|
| **高密度** | 每段一图 | 教程、图文并茂的科普 |
| **中密度** | 每2-3段一图（默认） | 一般文章、散文 |
| **低密度** | 每小节一图 | 长篇深度文章、学术内容 |
| **关键点** | 仅核心段落配图 | 商务报告、严肃内容 |

---

## 段落输出格式

```markdown
---
【段落 1】{段落标题或摘要}
配图建议：✅ 需要配图 / ⏭️ 可跳过

{段落正文内容}

---
【段落 2】{段落标题或摘要}
配图建议：✅ 需要配图

{段落正文内容}

---
```

---

## 不适合配图的段落

以下类型段落建议跳过配图：

| 类型 | 原因 |
|------|------|
| 纯数据/表格 | 数据本身即为视觉元素 |
| 引用块 | 通常用于引述，配图可能干扰 |
| 代码块 | 技术内容，图片无附加价值 |
| 过渡段 | 承上启下，内容较空 |
| 结尾致谢 | 非正文内容 |

---

## 特殊处理

### 列表段落
- 短列表（<5项）：整体作为一段，生成一张综合配图
- 长列表（≥5项）：考虑是否需要配图，或生成信息图风格

### 对话/问答
- 连续对话视为一个段落
- 配图侧重场景氛围而非具体对话内容

### 故事/叙事
- 按场景切换划分
- 配图侧重画面感最强的瞬间


path: references/style-presets.md
content: # 图片风格预设库

## 风格速查表

| 风格代号 | 风格名称 | 适用场景 | 核心关键词 |
|----------|----------|----------|------------|
| flat | 扁平插画 | 科技、商业、教程 | flat illustration, minimal, vector style |
| watercolor | 水彩风格 | 情感、文艺、生活 | watercolor painting, soft edges, dreamy |
| cartoon | 卡通风格 | 轻松、幽默、儿童 | cartoon style, bold outlines, vibrant colors |
| chinese | 国风水墨 | 传统文化、古典 | Chinese ink painting, traditional, elegant |
| tech | 科技感 | AI、数据、未来 | futuristic, neon, digital art, cyberpunk |
| minimal | 极简线条 | 高端、简约、商务 | minimalist, line art, white space |

---

## 风格详细说明

### 1. 扁平插画 (flat)

**核心提示词**：
```
flat illustration, vector style, minimal design, clean lines, 
solid colors, no shadows, modern, geometric shapes
```

**色调变体**：
- 暖色调：warm color palette, orange and yellow tones
- 冷色调：cool color palette, blue and green tones
- 莫兰迪：muted colors, morandi palette, soft tones

**适用文章类型**：科技资讯、产品介绍、教程指南、商业分析

---

### 2. 水彩风格 (watercolor)

**核心提示词**：
```
watercolor painting, soft edges, flowing colors, 
paper texture, artistic, dreamy atmosphere, hand-painted feel
```

**氛围变体**：
- 清新：light watercolor, pastel colors, airy
- 浓郁：rich watercolor, deep colors, expressive
- 留白：watercolor with white space, minimal strokes

**适用文章类型**：情感散文、生活随笔、旅行游记、文艺评论

---

### 3. 卡通风格 (cartoon)

**核心提示词**：
```
cartoon style, bold outlines, vibrant colors, 
exaggerated features, playful, fun, animated look
```

**细分风格**：
- 日系：anime style, Japanese animation
- 美系：American cartoon, Disney style
- 简笔画：simple cartoon, doodle style

**适用文章类型**：趣味科普、亲子内容、轻松话题、幽默杂文

---

### 4. 国风水墨 (chinese)

**核心提示词**：
```
Chinese ink painting, traditional brush strokes, 
rice paper texture, elegant, oriental aesthetic, 
black ink with subtle colors
```

**题材变体**：
- 山水：landscape, mountains and water
- 花鸟：flowers and birds, botanical
- 人物：figure painting, traditional costume

**适用文章类型**：传统文化、历史故事、古典文学、东方美学

---

### 5. 科技感 (tech)

**核心提示词**：
```
futuristic, digital art, neon lights, 
holographic, cyber, high-tech, glowing elements
```

**氛围变体**：
- 赛博朋克：cyberpunk, dark background, neon pink and blue
- 干净科技：clean tech, white and blue, minimalist futuristic
- 数据可视化：data visualization, abstract, flowing lines

**适用文章类型**：AI科技、互联网趋势、未来展望、数字化转型

---

### 6. 极简线条 (minimal)

**核心提示词**：
```
minimalist, line art, simple strokes, 
white background, elegant, sophisticated, 
negative space, single color accent
```

**变体**：
- 单线条：single line drawing, continuous line
- 几何：geometric minimal, abstract shapes
- 留白：lots of white space, zen aesthetic

**适用文章类型**：高端品牌、设计评论、简约生活、商务内容

---

## 图片比例参考

| 用途 | 比例 | 提示词参数 |
|------|------|------------|
| 公众号封面 | 2.35:1 | --ar 2.35:1 或 aspect ratio 2.35:1 |
| 公众号内文 | 16:9 | --ar 16:9 |
| 小红书配图 | 3:4 | --ar 3:4 |
| 正方形 | 1:1 | --ar 1:1 |
| 手机壁纸 | 9:16 | --ar 9:16 |

---

## 提示词组装模板

```
[主体], [场景], [风格关键词], [色调], [光线], [比例], no text, no letters, no words
```

**必须包含**：
- `no text, no letters, no words` — 避免图片中出现文字

**完整示例**：
```
A young entrepreneur working late at night in a small office, 
warm lamplight, coffee cups on desk, 
flat illustration style, warm color palette, 
soft ambient lighting, 16:9 aspect ratio, no text, no letters, no words
```

---

## 人物一致性处理

当文章中多次出现同一人物时，需保持角色外观一致：

**方法1：详细描述锚定**
```
首次出现时详细描述人物特征：
a young woman with short black hair, wearing a blue blazer, 
round glasses, confident expression

后续图片沿用相同描述
```

**方法2：角色标签**
```
在每个提示词中使用相同的角色描述前缀：
[Character: young Asian woman, short hair, blue blazer] + [具体场景]
```

**注意**：AI生图对人物一致性支持有限，建议：
- 保持相同的服装、发型、配饰描述
- 使用相同的风格关键词
- 必要时可接受轻微差异


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)