best-selling-book-writer

把你的书籍创意变成亚马逊畅销书 —— 用 AI。

从选题 → 大纲 → 章节 → KDP 元数据 → 格式化的 HTML/PDF 书籍。

适用于任何 AI 智能体：WorkBuddy、Claude Code、Codex、OpenClaw、Hermes，或任何有文件系统访问权限的智能体。无智能体特定依赖 —— 仅需 Python 3 + 可选的 Playwright。

---

功能概述

选题 → 大纲 → 章节 → KDP 元数据 → HTML + PDF 书籍

---

快速开始

1. 安装（克隆或复制）

# 克隆到任意位置
git clone https://github.com/YOUR_USERNAME/best-selling-book-writer.git
SKILL_DIR="$PWD/best-selling-book-writer"

# 或复制到智能体的 skills 目录
cp -r best-selling-book-writer ~/.workbuddy/skills/best-selling-book-writer/

2. 初始化书籍项目

python3 $SKILL_DIR/scripts/setup-book.py

按提示填写：

书名: 高功能焦虑症
副标题: 无人谈论的隐形疲惫
作者: 张三
目标读者: 30-40 岁的职场精英
书籍类型: [1] 自助类 / [2] 健康指南类
KDP Select（独家授权）? [y/N]: N

这会创建项目目录，包含 book-config.json、outline.md 和 chapters/ 文件夹。

3. 撰写章节

AI 智能体根据大纲撰写章节。每章采用以下结构：

# 第一章：导论

{开篇引子 — 2-3 段，具体的场景或问题。}

## 核心问题

{短段落，具体案例，七年级阅读水平。}

> **核心要点：** 一句清晰、好记的话。

**本章小结：**
{2-3 句话回顾本章内容。}

**本周行动：**
1. {具体、可操作的步骤}
2. {疲惫的人也能做到的事情}

保存到 chapters/ch01-introduction.md、chapters/ch02-understanding.md 等。

4. 生成 KDP 元数据

python3 $SKILL_DIR/scripts/generate-kdp-metadata.py --project ./high-functioning-anxiety

输出：high-functioning-anxiety/kdp-metadata.json，包含：

• title / subtitle / author
• description.html — KDP 合规的 HTML，≤4,000 字符
• keywords[] — 7 个 KDP 合规关键词，根据书籍主题自动生成
• validation{} — 字符计数、违禁内容检查

或使用交互模式：

python3 $SKILL_DIR/scripts/generate-kdp-metadata.py --project ./high-functioning-anxiety --interactive

5. 合并为书籍（HTML + PDF）

python3 $SKILL_DIR/scripts/merge-book.py --project ./high-functioning-anxiety

输出：

• Book-Output/high-functioning-anxiety.html — 完整格式化的书籍
• Book-Output/high-functioning-anxiety.pdf — 适合打印的 A4 PDF（需要 Playwright）

---

项目结构

my-book/
├── book-config.json      ← 所有书籍元数据（编辑此文件添加章节）
├── outline.md            ← 章节规划
├── kdp-metadata.json    ← 生成的 KDP 出版数据
├── chapters/             ← 所有章节 .md 文件（保留，不会被删除）
│   ├── ch01-intro.md
│   ├── ch02-understanding.md
│   └── ...
└── Book-Output/          ← 仅生成的输出文件
    ├── my-book.html
    └── my-book.pdf

---

book-config.json 字段说明

{
  "title": "高功能焦虑症",
  "subtitle": "无人谈论的隐形疲惫",
  "author": "张三",
  "topic": "高功能焦虑症",
  "target_audience": "30-40 岁的职场精英",
  "book_type": "self-help",
  "description": "一句话书籍简介",
  "kdp_select": false,
  "publisher": "你的出版社名称",
  "categories": [],
  "language": "zh-CN",
  "chapters": ["ch01-intro.md", "ch02-understanding.md"],
  "toc_items": ["导论", "理解高功能焦虑症"],
  "slug": "high-functioning-anxiety"
}

---

KDP 元数据

generate-kdp-metadata.py 脚本会创建 kdp-metadata.json，包含亚马逊 KDP 所需的全部字段。

描述规则

• 最大： 4,000 字符（含 HTML 标签 — 粗体标签也算！）
• 格式： 允许使用 HTML（、、、、``、-）
• 禁止 Emoji ❌
• 禁止 URL / 邮箱 ❌
• 禁止书评或推荐语 ❌
• 建议长度： ~800-1,000 字符（~150 字）

关键词规则

• 最多 7 个关键词或短语
• 建议使用 2-3 词短语
• 不要用引号包裹关键词
• 禁止促销语言（“畅销”、“免费”、“新”）
• 禁止通用词（“书”、“小说”）

自动生成

脚本根据以下信息自动生成 KDP 合规的描述和关键词：

• 你的 book_type（自助类 vs 健康指南类）
• 你的 topic 和 target_audience
• 常见主题的内置模板：围绝经期、焦虑、倦怠、长新冠、慢性病、照护者

校验项

脚本会校验：

• 书名 + 副标题字符数（< 200）
• 描述字符数（100–4,000）
• 描述中无 Emoji
• 描述中无 URL/邮箱
• 关键词数量（≤ 7）
• 关键词中无违禁短语

---

依赖

所有脚本基于 Python 3 标准库运行。playwright 仅用于 PDF 生成 —— HTML 不依赖它即可生成。

---

脚本

所有脚本支持配置文件自动发现 —— 会自动找到 book-config.json：

# 方式 1：显式指定项目路径（推荐）
python3 merge-book.py --project ./my-book

# 方式 2：显式指定配置文件路径
python3 merge-book.py --config ./my-book/book-config.json

# 方式 3：自动发现（在当前目录和 .workuddy/book-projects/*/ 中查找）
python3 merge-book.py

---

KDP 出版检查清单

上传到亚马逊 KDP 之前：

• [ ] 检查 kdp-metadata.json — 书名、副标题、作者是否准确
• [ ] 将 description.html 复制到 KDP 描述字段
• [ ] 输入 7 个关键词（不要加引号，不要使用促销语言）
• [ ] 从类别浏览器中选择最多 3 个亚马逊类别
• [ ] 设置语言和主要市场
• [ ] 上传封面图片（必须与元数据完全匹配）
• [ ] 设置定价和版权（KDP Select = 亚马逊独家）
• [ ] 发布前在 KDP 在线预览器中预览

---

文件地图

best-selling-book-writer/
├── README.md                       ← 你在这里
├── SKILL.md                        ← AI 智能体指令
├── scripts/
│   ├── setup-book.py               ← 阶段 1：项目初始化
│   ├── generate-kdp-metadata.py    ← 阶段 3：KDP 元数据
│   └── merge-book.py               ← 阶段 5：HTML + PDF 生成
└── references/
    ├── kdp-metadata.md             ← KDP 字段规格与违禁内容
    └── writing-style.md            ← 章节写作指南

---

许可证

MIT

---

更新日志

v1.1 — 2026-05

• 完整重写：五阶段工作流（选题 → 大纲 → 写作 → KDP 元数据 → 合并）
• 新增 generate-kdp-metadata.py — 自动生成 KDP 合规的书名、描述、关键词
• 新增 references/kdp-metadata.md — KDP 字段规格、字符限制、违禁内容
• 新增 references/writing-style.md — 章节写作指南（七年级水平，温暖对话式语调）
• 智能体无关化 — 移除 WorkBuddy 特定引用，适用于任何 AI 智能体
• 保留原始章节文件在 chapters/ 中（合并时不会被删除）
• book-config.json 扩展 KDP 字段：topic、target_audience、book_type、kdp_select、publisher

v1.0 — 更早版本

• 初始书籍合并功能（Markdown → HTML → PDF）