Skills DirectorySearch all skills ↗AI agent skill · by @kangarooking
Book Illustration Workflow
用于处理写书过程中的章节截图与插图工作流。适用于：梳理某一章需要哪些截图、逐步给出 Claude Code 实操提示词、规定截图文件名与图号映射、回填本地 Markdown 中的图片位置、清理作者备注为读者版正文、以及把章节和图片按正确位置同步到 Feishu 文档。用户如果提到“书的截图”“章节配图”“图号对应”“放到原文里”“上传飞书文档”“按刚才那套流程来”，应触发此 skill。
Archived 2026-10-23 · Source updated 2026-09-07. Check the original repository for the latest version.
SKILL.md instructions
# 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 - 如果暂时没有图片，只保留简洁的读者可见表述，不保留编辑备注 图片插入格式优先： ```md  ``` ### 阶段 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](references/chapter-illustration-template.md) ## 质量检查清单 在宣布完成前，必须自查： - 每张图片是否和对应图号匹配 - 提示词是否像真实办公任务 - 是否还残留作者备注 - 本地 Markdown 里的图片顺序是否正确 - Feishu 中图片是否跟着正确段落走 - 是否存在 `图7-1` 误匹配 `图7-10` 这类问题 ## 默认回答风格 如果用户说“按这个流程来”，默认这样执行： 1. 先检查目标章节文件和图片目录 2. 如果需要截图指导，进入一步一步模式 3. 如果截图已经完成，优先修本地 Markdown 4. 本地确认后，再同步 Feishu ## 不要做的事 - 不要把写给作者自己的编辑备注留在读者版正文 - 不要在截图提示词里暴露“这是为了写书” - 不要按大块素材占位盲插图片 - 不要在旧 Feishu 文档上反复乱修，造成更多错位 - 不要用模糊文件匹配规则批量找图