把一个书籍创意变成可上架亚马逊 KDP 的电子书：选题 → 大纲 → 章节 → KDP 元数据 → 格式化 HTML / PDF。主打自助类与健康指南类非虚构图书。
不绑定特定 Agent：WorkBuddy、Claude Code、Codex、Cursor 等只要能读写文件、能跑 python3 就能用。脚本全部基于 Python 3 标准库，只有导出 PDF 时才需要可选的 Playwright。
做什么
| 阶段 | 说明 |
|---|---|
| 选题 | 确定书名、目标读者、要解决的核心问题，初始化项目目录与 book-config.json |
| 大纲 | 规划 8–10 章 + 附录，写入 outline.md |
| 写作 | 每章 800–1,200 字，七年级阅读水平；固定结构：开篇场景 → 核心问题 → 核心要点 → 本章小结 → 本周行动 |
| KDP 元数据 | 自动生成书名、副标题、≤4,000 字符的 HTML 描述和 7 个关键词，并校验 Emoji、URL、促销词等违禁项 |
| 合并 | 把 chapters/ 下的 Markdown 合成一本带目录的 HTML，可选导出 A4 PDF |
章节原稿始终保留在 chapters/，合并只往 Book-Output/ 追加产物，方便反复修改和重新出版。
怎么装
克隆到 Agent 的 skills 目录（目录名与 SKILL.md 里的 name 保持一致）：
git clone https://github.com/duchangyu/best-selling-book-writer-skill.git ~/.cursor/skills/best-selling-book-writer- Claude Code：
~/.claude/skills/best-selling-book-writer - Codex：
~/.codex/skills/best-selling-book-writer - Cursor：
~/.cursor/skills/best-selling-book-writer或项目内.cursor/skills/best-selling-book-writer
需要 PDF 时再装 Playwright：
pip install playwright && playwright install chromium装好后直接说「写一本书」「新建书籍项目」「生成 KDP 元数据」「合并章节导出 PDF」即可触发。也可以手动跑三个脚本：setup-book.py（初始化）、generate-kdp-metadata.py --project ./my-book（元数据）、merge-book.py --project ./my-book（成书）。
何时用
- 想把一个专业领域或个人经验整理成一本 2–3 万字的非虚构小书
- 准备在亚马逊 KDP 自出版，需要合规的描述、关键词和上架检查清单
- 已经有一堆 Markdown 章节，只差合并成排版干净的 HTML / PDF
内置描述模板偏向围绝经期、焦虑、倦怠、长新冠、慢性病、照护者等健康主题；其他题材可用交互模式（--interactive）手动补充。