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 的内容：

<真实提示词>

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

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

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

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

要求：

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

阶段 C：回填本地文章

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

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

处理方式：

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

图片插入格式优先：

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

章节截图总表模板

在开始做某一章截图前，先复制这份表，逐项填完。这样后面的截图执行、原文回填和 Feishu 同步都不会乱。

用法

1. 先通读章节 2. 把所有图号列出来 3. 区分哪些是：

• 原始数据图
• Claude Code 对话图
• 成品图
• 对比图
• 官方页面图

4. 给每张图确定：

• 真实提示词
• 截图对象
• 文件名
• 原文位置

5. 每完成一张就更新状态

总表模板

| 图号 | 图名 | 类型 | 截图对象/结果对象 | 给 Claude Code 的提示词 | 是否需要浏览器/表格软件 | 保存文件名 | 原文位置 | 是否已完成 | 备注 |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| 图7-1 | 原始脏数据样本 | 原始数据图 | Excel/CSV 原始文件 | 不需要 Claude Code | 表格软件 | 图7-1_原始脏数据样本.png | 7.2.1 原始数据说明后 | [ ] | 只截 6-10 行 |
| 图7-2A | 添加官方 Skills marketplace | 安装界面图 | Claude Code | /plugin marketplace add anthropics/skills | Claude Code | 图7-2A_添加官方Skills市场.png | 安装命令后 | [ ] | 保留命令和成功反馈 |
| 图7-2B | 安装 document-skills | 安装界面图 | Claude Code | /plugin install document-skills@anthropic-agent-skills | Claude Code | 图7-2B_安装document-skills.png | 安装命令后 | [ ] | 保留安装成功反馈 |
| 图7-8A | 调用 xlsx 清洗数据界面 | 对话图 | Claude Code | <正式清洗提示词> | Claude Code | 图7-8A_调用xlsx清洗数据界面.png | 正式清洗指令后 | [ ] | 同时保留输入和输出开头 |
| 图7-18 | 报表首页示例 | 成品图 | PNG 报表页 | <报表首页提示词> | 图片预览 | 图7-18_报表首页示例.png | 报表首页说明处 | [ ] | 优先成品图，不用聊天界面 |

提示词模板

1. 安装图

/plugin marketplace add anthropics/skills

/plugin install document-skills@anthropic-agent-skills

2. 检查图

请先检查“<数据文件夹>”里的所有表格，告诉我目前有哪些明显问题，重点看：

1. 表头是否一致
2. 日期格式是否统一
3. 是否有空值
4. 是否有重复记录
5. 哪些字段可能需要我确认后再处理

先给我问题清单，不要直接修改文件。

3. 正式处理图

请处理“<数据文件夹>”里的所有表格，并按下面规则输出最终汇总表：

1. 合并多份同类表格
2. 把“<字段别名A>”“<字段别名B>”“<字段别名C>”统一成“<统一字段名>”
3. 日期统一成 YYYY-MM-DD
4. 删除完全重复的记录
5. 对缺失值按规则标记
6. 保留核心字段
7. 输出一份整理后的汇总表
8. 另外给我一份处理说明

4. 图表图

请根据“<汇总文件.xlsx>”生成一张适合汇报使用的<趋势图/对比图>，并导出为 PNG 图片，要求：

1. 主题明确
2. 让人一眼看出重点
3. 风格简洁、专业
4. 图片尺寸适合直接用于PPT或文档

5. 报表图

请根据“<汇总文件.xlsx>”生成一页适合直接用于周报或月报的报表页面，并导出为 PNG 图片，要求：

1. 包含核心指标
2. 包含至少一张图表
3. 版面完整
4. 风格简洁、专业

回填检查表

| 检查项 | 是否完成 |
| --- | --- |
| 每张图都已经落到正确图号 | [ ] |
| 文件名和图号完全一致 | [ ] |
| 正文里没有作者备注 | [ ] |
| 图片位置跟着正文语义走 | [ ] |
| Feishu 文档顺序和本地一致 | [ ] |
| 不存在错图或重复图 | [ ] |