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
- 如果暂时没有图片，只保留简洁的读者可见表述，不保留编辑备注

图片插入格式优先：