# Book Illustration Workflow

用于处理写书过程中的章节截图与插图工作流。适用于：梳理某一章需要哪些截图、逐步给出 Claude Code 实操提示词、规定截图文件名与图号映射、回填本地 Markdown...

- Repository: https://github.com/kangarooking/kangarooking-skills (694 stars)
- Category: AI and agents
- License: see repository
- Last updated: 2026-09-07
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add kangarooking/kangarooking-skills --skill book-illustration-workflow -g -a claude-code -y`
Codex: `npx skills add kangarooking/kangarooking-skills --skill book-illustration-workflow -g -a codex -y`
Cursor: `npx skills add kangarooking/kangarooking-skills --skill book-illustration-workflow -g -a cursor -y`
Gemini CLI: `npx skills add kangarooking/kangarooking-skills --skill book-illustration-workflow -g -a gemini-cli -y`

## Description

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

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

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

图片插入格式优先：

The rest: https://github.com/kangarooking/kangarooking-skills/blob/HEAD/book-illustration-workflow/SKILL.md