---
name: book-illustration-workflow
description: 用于处理写书过程中的章节截图与插图工作流。适用于：梳理某一章需要哪些截图、逐步给出 Claude Code 实操提示词、规定截图文件名与图号映射、回填本地 Markdown 中的图片位置、清理作者备注为读者版正文、以及把章节和图片按正确位置同步到 Feishu 文档。用户如果提到“书的截图”“章节配图”“图号对应”“放到原文里”“上传飞书文档”“按刚才那套流程来”，应触发此 skill。
---

# Book Illustration Workflow

这个 skill 处理的是“章节截图从规划到落文再到飞书同步”的完整流程。

## 目标

把一章书稿中的插图工作拆成稳定流程：

1. 明确章节里真正需要的截图和成品图
2. 逐步给出可在 Claude Code 中执行的真实提示词
3. 约束截图文件名、图号和正文位置一一对应
4. 把图片放回本地 Markdown 的正确位置
5. 清除不该给读者看到的作者备注
6. 把读者版章节和图片同步到 Feishu

## 触发条件

当用户有下面任一意图时使用：

- 让你帮他做书稿某一章的截图流程
- 让你逐步指导 Claude Code 截图或生成图
- 让你整理“图号 -> 提示词 -> 文件名 -> 原文位置”
- 让你把图片插回本地文章
- 让你把章节同步到 Feishu 文档
- 让你“按上次那套流程继续”

## 核心原则

### 1. 截图里的提示词必须像真实工作

给 Claude Code 的提示词里，禁止出现这些词：

- `书`
- `章节`
- `案例`
- `演示`
- `截图`
- `适合展示`
- `chapter7-demo`
- `为了写书`

截图里的用户输入必须像真实办公任务。

### 2. 数据准备放在截图外

不要把“造测试数据”“建目录供截图使用”“为了展示准备样本”放进 Claude Code 对话。

正确做法：

- 截图外准备数据
- 截图内只展示真实使用

### 3. 一次只推进一步

如果用户要求“我们一步一步来”，每次只给：

1. 发给 Claude Code 的内容
2. 要截哪一屏
3. 截图保存名
4. 对应原文位置
5. 原文里是否已有占位

用户完成后，再给下一步。

### 4. 图片位置按正文语义，不按占位块整坨插

如果文章里存在这种编辑痕迹：

- `素材占位`
- `插图占位`
- 一组图号集中挂在小节开头

不要机械地把图片全塞到那一块。

正确做法：

- 找到正文里真正引出该图的句子
- 把图片放在那句或那段后面
- 同步 Feishu 时也按这个顺序上传

### 5. 给读者看的正文不能保留作者备注

这些内容不应出现在读者版正文或 Feishu 文档中：

- `素材占位`
- `插图占位`
- `建议拍法`
- `建议做法`
- `插图说明文案`
- `来源提示`
- `如果这里配一张……`
- `如果你在书里配图……`
- `你在书里可以……`

处理原则：

- 有价值的信息改写成面向读者的正文
- 纯编辑备注直接删掉
- 已完成截图的，直接换成实际图片

## 标准流程

### 阶段 A：梳理章节

1. 找到目标章节 Markdown 文件
2. 找出所有图号、代码块、表格占位和“素材占位”段
3. 判断哪些图是：
   - 原始数据截图
   - Claude Code 对话截图
   - 成品图表/报表
   - 外部官方页面截图
   - 后期拼版图
4. 给出最小可执行截图顺序

优先顺序通常是：

1. 安装或环境确认
2. 原始数据图
3. 核心任务调用图
4. 结果图
5. 对比图
6. 扩展应用图

如果需要快速建立整章截图计划，优先使用 [references/chapter-illustration-template.md](references/chapter-illustration-template.md) 里的总表模板。它适合在正式截图前先把“图号、用途、提示词、文件名、原文位置、是否完成”一次性列清。

### 阶段 B：逐步指导截图

如果用户要一步一步执行，按这个模板输出：

```md
第N步：<动作名称>

发给 Claude Code 的内容：
```text
<真实提示词>
```

你要截哪一屏：
- <明确说明保留输入 / 输出 / 结果图>

截图保存名：
- <文件名.png>

对应原文位置：
- <章节中的位置或图号说明>

原文里现在有没有占位符：
- 有 / 没有
```

要求：

- 不抢跑后续步骤
- 不一次给太多
- 文件名直接可落盘

### 阶段 C：回填本地文章

先检查本地 Markdown 是否属于哪一种：

1. `读者版正文 + 独立图片占位`
2. `作者版正文 + 大块素材占位`
3. `正文里夹着大量编辑备注`

处理方式：

- 如果还是作者版，先清理成读者版
- 如果图片已经有了，直接在正文中插入图片 Markdown
- 如果暂时没有图片，只保留简洁的读者可见表述，不保留编辑备注

图片插入格式优先：

```md
![图7-10 趋势图成品示例](第七章图片/图7-10_趋势图成品示例.png)
```

### 阶段 D：同步到 Feishu

同步 Feishu 时，不要在旧文档上盲改大批错位图片。优先做法：

1. 先把本地 Markdown 修成读者版
2. 按“markdown 段落 -> 对应图片 -> 下一段”的顺序切分
3. 新建一份 Feishu 文档上传
4. 让新文档成为主文档

只有在用户明确要求保留原文档时，才在旧文档上修补。

### 阶段 E：Feishu 上传规则

使用 `lark-cli` 时：

- `docs +create` 创建文档
- `docs +update --mode append` 追加 markdown
- `docs +media-insert` 插图

注意：

- 图片必须按正文顺序插
- 不要按“图号排序”插，必须按文章出现顺序
- 如果文件名有前缀冲突，例如 `图7-1` 会误匹配 `图7-10`，必须做精确匹配

精确匹配规则：

- 只能匹配 `^(图号)(_|\\.|$)` 这种边界
- 不能用简单前缀包含

## 命名规则

截图文件名默认采用：

- `图号_简短说明.png`

例如：

- `图7-2A_添加官方Skills市场.png`
- `图7-8A_调用xlsx清洗数据界面.png`
- `图7-18_报表首页示例.png`

要求：

- 图号必须在文件名前部
- 中文说明尽量短
- 后续插文和上传 Feishu 都依赖这个命名

## 附带模板

- 章节截图总表模板：见 [references/chapter-illustration-template.md](references/chapter-illustration-template.md)

## 质量检查清单

在宣布完成前，必须自查：

- 每张图片是否和对应图号匹配
- 提示词是否像真实办公任务
- 是否还残留作者备注
- 本地 Markdown 里的图片顺序是否正确
- Feishu 中图片是否跟着正确段落走
- 是否存在 `图7-1` 误匹配 `图7-10` 这类问题

## 默认回答风格

如果用户说“按这个流程来”，默认这样执行：

1. 先检查目标章节文件和图片目录
2. 如果需要截图指导，进入一步一步模式
3. 如果截图已经完成，优先修本地 Markdown
4. 本地确认后，再同步 Feishu

## 不要做的事

- 不要把写给作者自己的编辑备注留在读者版正文
- 不要在截图提示词里暴露“这是为了写书”
- 不要按大块素材占位盲插图片
- 不要在旧 Feishu 文档上反复乱修，造成更多错位
- 不要用模糊文件匹配规则批量找图