content-illustrator：内容插图工具

把文字变成图，三种用法，一个 skill 搞定。

适用边界

• ✅ 用我：文字描述 → SVG；分析文章找插图时机；批量补全课程文件里的图片占位
• ❌ 不用我：需要 AI 绘图风格（照片/插画）→ 用 hd-infoimage；截图/录屏 → 手动操作

模式识别（先判断用哪种模式）

触发词不明确时，问用户：「是要直接生成一张图、分析文章找插图位置，还是批量补全占位符？」

SVG 生成规范（三种模式共用）

所有 SVG 遵循统一规范，执行前必读： ../course-generator/references/image-protocol.md

核心要点（快速回顾）：

• 画布：viewBox="0 0 620 480" width="620" height="480"
• 字体：'PingFang SC', 'Hiragino Sans GB', 'Microsoft YaHei', sans-serif
• 节点：浅色背景 + 深色左侧色条，圆角 rx="10"
• 箭头：每条连线必须有文字标注
• 配色：蓝 #E8F4FD/#4A9FD4、绿 #EAF7EE/#52A96A、橙 #FEF3E8/#E08A3A
• 验证：用 Bash 工具 open <路径> 本地预览后再插入

生成后按 A 方案插入（注释保留 + 图片引用追加）：

<!-- [流程图] 描述：... -->
![alt 文字](相对路径/xxx.svg)

模式 A：描述生图

触发：用户直接给出图片描述。

流程：

1. 从描述中提取图表类型（见类型识别表）和核心内容
2. 读取 image-protocol.md 第 5 节提示词模板，将 {描述} 替换为用户提供的描述文本
3. 生成 SVG，命名规则：<slug>.svg（2-4 个英文词 + - 连接）
4. 询问用户存放路径（或用户已指定时直接写入）
5. 用 Bash 工具 open 预览
6. 报告：文件路径 + 是否需要插入某篇文章

类型识别表：

模式 B：文章分析

触发：用户提供文章路径或内容，要求找插图时机。

流程：

B1. 读取文章

用 Read 工具读取指定文件（或用户粘贴的内容）。

B2. 识别插图候选位置

逐段扫描，按以下信号识别「看图比看字快」的位置：

不插图的位置：纯文字叙述、举例说明、引用、代码块（代码本身就是视觉）。

B3. 输出分析报告

格式：

## 插图分析报告

建议插入 N 处：

### 位置 1（第 X 节 / 第 X 行附近）— 🔴 高优先级
- 类型：流程图
- 原因：此处描述了 3 步操作流程，用流程图能省掉一段解释
- 描述草稿：「XXX 流程：步骤一 → 步骤二 → 步骤三，标注 XXX」

### 位置 2 ...

B4. 逐一确认并生成

报告输出后，询问用户：「要现在生成哪几处？全部生成还是指定位置？」

用户确认后，逐一按模式 A 的流程生成 SVG，并按 A 方案插入文章。

模式 C：批量补图

触发：用户指定目录或文件，要求补全占位符。

流程：

C1. 扫描占位符

grep -rn "<!-- \[流程图\]\|<!-- \[对比图\]" <目录路径>

C2. 过滤已有图片的占位（跳过不重复生成）

检查每个占位符的下一行是否已有 ![]() 或 <img 引用，有则跳过。

C3. 输出待处理清单

发现 N 处待补图占位：

1. CC-005:33 — [流程图] 三层 CLAUDE.md 加载顺序...
2. CC-006:19 — [流程图] Skills 三级加载机制...
...

全部生成约需 ~N×1000 tokens。是否全部生成？（可指定范围，如「只生成 1-5」）

C4. 用户确认后逐一生成

对每条占位，读取描述文本 → 生成 SVG → A 方案插入（注释保留 + 图片引用追加）。

每张完成后报告进度：✅ CC-005:33 → cc005-claudemd-hierarchy.svg

C5. 完成报告

✅ 批量补图完成
生成：N 张 SVG
跳过（已有图片）：N 处
失败（描述不清，已保留占位）：N 处

文件命名与存放

• 命名：<来源编号小写>-<内容slug>.svg，如 cc005-claudemd-hierarchy.svg
• 存放：与文章同级的 assets/ 目录，或用户指定路径
• 不确定时，询问用户：「SVG 存放在哪个 assets 目录？」