book-illustration-workflow

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 里的总表模板。它适合在正式截图前先把“图号、用途、提示词、文件名、原文位置、是否完成”一次性列清。

阶段 B：逐步指导截图

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

第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

质量检查清单

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

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

默认回答风格

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

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

不要做的事

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