Book Illustration Workflow

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 文档上反复乱修，造成更多错位
• 不要用模糊文件匹配规则批量找图