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"
}