AgentSkillsCN

content-illustrator

内容插图规划工具。当用户说“为文章配图”、“为文章生成插图”、“给文章配图”、“分析文章并配图”、“自动插图”、“为文章生成配图”时，可触发此技能。 工作流程： 1. 读取文章内容（read_file） 2. 分析需要插图的位置 3. 选择合适的风格（14种风格可选） 4. 调用image-generation技能生成图片 5. 更新文章，插入图片引用 支持风格：tech、fresh、minimal、warm、business、elegant、bold、 playful、nature、sketch、notion（默认）

SKILL.md
--- frontmatter
name: content-illustrator
description: |
  内容插图规划工具。当用户说"给文章配图"、"为文章生成插图"、"文章配图"、
  "分析文章并配图"、"自动插图"、"为文章生成配图"时触发此技能。

  工作流程：
  1. 读取文章内容（read_file）
  2. 分析需要插图的位置
  3. 选择合适的风格（14种风格可选）
  4. 调用 image-generation 技能生成图片
  5. 更新文章，插入图片引用

  支持风格：tech、fresh、minimal、warm、business、elegant、bold、
  playful、nature、sketch、notion（默认）

文章插图生成技能

核心功能

AI 驱动的插图规划系统，自动分析文章结构，识别需要视觉辅助的位置，并调用项目内置的豆包 Seedream 4.5 API 生成高质量插图。

风格系统

支持 14 种精细风格：

现有风格（5种）

  • •tech - 专业科技（AI、编程、技术文档）
  • •fresh - 清新活泼（生活分享、学习笔记）
  • •minimal - 简约极简（哲学思考、深度观点）
  • •warm - 温暖治愈（情感文章、成长感悟）
  • •business - 商务专业（数据报告、市场分析）

新增风格（9种，来自宝玉）

  • •elegant - 优雅精致（商业分析、领导力内容）
  • •bold - 高对比冲击（观点文章、重要提醒）
  • •playful - 活泼趣味（教程指南、轻松内容）
  • •nature - 自然有机（环保健康、自然主题）
  • •sketch - 手绘草图（头脑风暴、创意过程）
  • •notion - Notion 极简（知识分享、概念解释）[默认]

工作流程

步骤 1：分析内容与选择风格

  1. •

    读取文章内容

    • •使用 read_file 工具读取文章文件
    • •提取标题、章节结构和核心主题
  2. •

    自动风格匹配

    • •分析文章标题和内容关键词
    • •匹配最佳风格（基于风格关键词库）
    • •如未指定，默认使用 notion 风格
  3. •

    内容类型识别

    • •技术文章 → tech/elegant
    • •成长感悟 → warm/nature
    • •教程指南 → playful/fresh
    • •观点文章 → bold
    • •知识分享 → notion/minimal

步骤 2：识别插图位置

插图三大目的：

  1. •信息补充：帮助理解抽象概念
  2. •概念可视化：将抽象想法转化为具体视觉
  3. •想象力引导：创造氛围，增强阅读体验

适合插图的内容：

  • •✅ 需要可视化的抽象概念（如"微服务架构"、"递归算法"）
  • •✅ 需要图解的流程/步骤（如"部署流程"、"操作步骤"）
  • •✅ 需要视觉化对比的内容（如"方案A vs 方案B"）
  • •✅ 需要强化的核心论点（如"3个关键原因"）
  • •❌ 已有图片或代码截图
  • •❌ 纯文字段落

插图数量原则：

  • •每个主要章节至少 1 张
  • •多于少好，避免过度
  • •建议：3-5张（对于中等长度文章）

步骤 3：生成插图计划

创建结构化的插图计划（markdown 格式）：

markdown
# 插图计划

## 元信息
- 文章路径：`{{article_path}}`
- 风格：{{matched_style}}
- 插图数量：{{count}} 张
- 生成时间：{{timestamp}}

## 插图列表

### 插图 1：{{illustration_title}}
- **插入位置**：{{chapter_name}} 章节，第 X 段落后
- **用途**：{{purpose}}（如：解释微服务的三层架构）
- **视觉内容**：{{visual_description}}（如：从上到下依次是API网关、业务服务、数据层，箭头表示数据流向）
- **尺寸**：1792x1024（16:9横版）
- **文件名**：`assets/images/01-{{slug}}.png`
- **提示词草稿**：{{prompt_draft}}

---

### 插图 2：...

步骤 4：调用 image-generation 技能

对于每一张需要生成的图片：

重要：必须使用 run_command 工具执行命令，不能只生成脚本。

  1. •构建完整的命令：
bash
python resources/skills/image-generation/scripts/doubao_image_gen.py \
  --prompt "{{从插图计划提取的提示词}}" \
  --size "1792x1024" \
  --quality "hd" \
  --output "assets/images/01-{{slug}}.png"
  1. •使用 run_command 工具执行：

调用格式：

code
使用 run_command 工具执行上述命令
  1. •确认生成成功：
  • •检查返回信息中是否包含 "Successfully wrote to"
  • •确认文件已创建到指定路径
  1. •处理错误：
  • •

    如果提示 "DOUBAO_API_KEY environment variable is not set"：

    • •告知用户需要在设置面板配置豆包 API Key
    • •提供配置指导：打开应用 → 设置 → API 配置 → 豆包 API Key
  • •

    如果提示 "No such file or directory"：

    • •使用 run_command 创建目录：mkdir -p assets/images
    • •然后重新执行生图命令
  • •

    如果提示其他错误：

    • •记录完整错误信息
    • •提供备选方案（使用 cover-generator 或在线工具）

环境变量注入：

  • •DOUBAO_API_KEY：从 ConfigStore 自动读取
  • •Agent 运行时会自动处理环境变量注入
  • •无需手动设置

步骤 5：更新文章

在文章的指定位置插入图片引用：

markdown
## 微服务架构概述

微服务是一种架构风格...

![微服务三层架构图](assets/images/01-microservices-architecture.png)

如上图所示，微服务架构分为三层...

步骤 6：输出总结

生成完成后的总结报告：

markdown
✅ 插图生成完成

**文章**：{{article_path}}
**风格**：{{matched_style}}
**生成数量**：{{count}} 张

**生成清单**：
1. ✅ {{illustration_1}} - assets/images/01-xxx.png
2. ✅ {{illustration_2}} - assets/images/02-xxx.png
...

**插图计划**：`assets/illustration-plan.md`
**文章已更新**：图片已插入到指定位置

错误处理

图片生成失败

  • •提供详细错误信息
  • •建议使用备选方案（cover-generator、Canva等）
  • •保存已成功生成的图片

文件写入失败

  • •检查文件权限
  • •提供备用路径建议

风格匹配失败

  • •默认使用 notion 风格
  • •提示用户可手动指定风格

最佳实践

  1. •先分析后生成：确保插图位置合理，避免盲目生成
  2. •批量生成限制：每次最多生成 5 张，避免超时
  3. •文件组织：所有图片保存在文章项目的 assets/images/ 目录
  4. •命名规范：{序号}-{slug}.png，便于管理

示例场景

示例 1：技术文章自动配图

用户输入：

code
为我的文章《深入理解微服务架构》生成配图

AI 执行流程：

  1. •读取文章内容，识别为技术文章
  2. •自动匹配 tech 风格
  3. •分析文章结构，识别需要插图的位置：
    • •"微服务架构概述" → 需要架构图
    • •"服务间通信" → 需要通信流程图
    • •"数据一致性" → 需要对比图
  4. •生成 3 张插图并插入文章
  5. •输出总结报告

示例 2：成长感悟文章配图

用户输入：

code
给文章《我的2023年成长总结》配图，使用温暖治愈风格

AI 执行流程：

  1. •读取文章，用户指定 warm 风格
  2. •识别关键成长节点，需要 2 张配图：
    • •"年初迷茫期" → 温暖的启程图
    • •"年末收获" → 充满希望的成果图
  3. •生成配图并插入
  4. •完成总结

参考文档