书本制造者
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_c51c610f/write-a-book。
技能介绍
要解决什么问题
写书往往卡在「大纲有了,Word 里怎么凑成一本能交稿的文档」:封面、内容简介、章节样式、目录和页码各有一套惯例,纯靠对话一次性吐完全书还容易超长、难保存。若还要封面图和章内插图,多数模型直接在图里写字并不可靠。
技能如何工作
本技能把流程固定为 需求确认 → 规划大纲 → 初始化文档 → 分块写章 → 润色交付,并围绕 python-docx 做增量写入。
- 三种体裁模板:小说/故事、教程/技术书、非虚构/干货,各自有大纲结构与
content_list格式(场景分隔、代码块、表格与「本章小结」等)。 - 出版向 Word 结构:
init_book()生成封面与约 300 字内容简介;正文用 Heading 1–3;全书写完后add_toc_page()插入 TOC 域,用户在 Word 里「更新域」即可出目录;finalize_book()加页眉书名与页脚页码。 - 分块策略:每次写 2–3 章即写入并保存,长书每批校验文件可打开,必要时中间另存草稿版本。
- 封面与插图:遵循 AI 只出图、文字用 Pillow 排版;支持阿里云百炼 / OpenAI 等 Provider,无 API Key 时退化为纯文字封面与无插图章节。
适用边界与注意点
- 依赖 Python 3 与
python-docx、Pillow、requests等版本(见技能内requirements.txt)。 - 目录页码以 Word 打开后更新 TOC 为准;中文字体需通过
set_cn_font()设置,否则易出现显示异常。 - 插图生成会消耗外部 API;生成前应对 prompt 做确认,并优先用环境变量保管密钥。
使用场景
- 教程目录已定,需按章生成含代码块、练习题与 Heading 样式的 Word 书稿,并在正文完成后插入可更新的 TOC 目录。
- 写小说或长篇故事时,每次只写 2~3 章就写入并保存 docx,避免单次上下文过长,同时保留场景分隔与统一人称。
- 非虚构书稿每章要先论点、再用案例或数据论证,并输出带「本章小结」与表格的 A4 规范 docx。
- 需要交稿用的封面、约 300 字内容简介与页眉页码;有图 API 时做 AI 背景 + Pillow 排版封面,没有则退化为纯文字封面。
适合人员
- 已写好教程/技术书大纲的作者,要把知识点拆成 3~5 点/章并落到可印刷排版的 Word 终稿
- 连载或完本小说作者,要在 docx 里维护场景格式,并视需要为关键场景生成无文字的章节插图
- 内训或出版向的非虚构写作者,需要引用标注、数据表格与每章小结等固定结构
- 能在本地跑 Python 的创作者,愿意按 init_book / add_chapter / finalize_book 分步执行并每批检查 docx 是否正常打开