# Leadbook

生产独立高质量中文商业短书、白皮书、方法论书、操作手册和 PDF 引流品的写书工作流。适用于用户说“写白皮书”“写引流书”“写方法论短书”“写商业手册”“写 PDF...

- Repository: https://github.com/zjp1997720/zhijian-skills (788 stars)
- Category: Documents
- License: MIT
- Last updated: 2026-10-26
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add zjp1997720/zhijian-skills --skill leadbook -g -a claude-code -y`
Codex: `npx skills add zjp1997720/zhijian-skills --skill leadbook -g -a codex -y`
Cursor: `npx skills add zjp1997720/zhijian-skills --skill leadbook -g -a cursor -y`
Gemini CLI: `npx skills add zjp1997720/zhijian-skills --skill leadbook -g -a gemini-cli -y`

## Description

生产独立高质量中文商业短书、白皮书、方法论书、操作手册和 PDF 引流品的写书工作流。适用于用户说“写白皮书”“写引流书”“写方法论短书”“写商业手册”“写 PDF 书”“写企业 AI 落地白皮书”“写个人 IP 白皮书”“写超级个体商业操作系统”“写内容获客手册”。正文必须独立成书，不写销售 CTA，不绑定课程、企微、咨询或分身系统；可额外生成书外分发说明和私域运营包。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Leadbook

用于把一个商业主题写成独立、高质量、可公开传播的中文短书或白皮书。它继承 `tech-book` 的工程化写书骨架，但输出目标从技术出版改为普适商业认知与行动资产。

## 核心边界

- 正文必须独立成立：读者不购买任何产品，也能完整受益。
- 正文禁止硬 CTA：不写“加企微”“领取资料”“购买课程”“咨询我”等转化话术。
- 正文不绑定大鹏的分身系统、课程、定制、企业培训。
- 书外可以生成 `distribution-note.md` 和 `private-domain-pack.md`，但它们不得进入正式 PDF。
- 第一版默认写 30-50 页中文短书，不做 200 页大部头。
- Core 链路只依赖 Python 标准库，可完成脚手架、章节同步、Markdown 导出和质量检查。
- 通用模式默认使用公开 Web；小红书、公众号采集、Nowledge、Obsidian 和 Vault 都是可选 Provider，缺失时不得阻塞成书。
- 正式 PDF 可选使用 `$kami` 的中文 `long-doc.html` 风格：暖纸底、ink-blue、克制 editorial 排版。
- 正文配图优先使用 Kami 信息图：结构、流程、对比、公式、清单。`$imagegen` 主要用于封面、章节扉页和书外分发图。

## 快速开始

新建一本书时，优先运行脚手架：

```bash
LEADBOOK_SKILL_DIR="/path/to/installed/leadbook"
python3 "$LEADBOOK_SKILL_DIR/scripts/scaffold_leadbook.py" \
  "/path/to/books/超级个体商业操作系统" \
  --title "超级个体商业操作系统" \
  --content-profile methodology-book \
  --voice-profile product-architect \
  --author "大鹏"
```

脚手架会复制 `assets/repo-template/`，自动同步章节并生成带安全标记的标准 book repo。`--force` 只允许替换带 `.leadbook-project.json` 标记的既有 Leadbook 项目。之后按阶段工作，不要直接在聊天里散写全文。

完整成书属于耐久任务。每个 Phase 完成后运行 `python3 scripts/leadbook-stage.py mark <phase>`，把可恢复检查点写入 `.leadbook-run.json`。恢复时先运行 `python3 scripts/leadbook-stage.py next`，从第一个未完成阶段继续。具体规则见 [执行检查点](references/execution-checkpoints.md)。

运行前按需读 [运行时与隐私边界](references/runtime-and-privacy.md)。Kami、小红书和公众号采集都是可选 Provider，不阻塞 Core 链路。

## 工作流

### Phase 1：Book Brief

先写清楚这本书为什么存在。产出并维护：

- `BOOK_BRIEF.md`：书名、副标题、目标、边界、完成标准。
- `READER_PROFILE.md`：读者是谁、处境、痛点、阅读动机。
- `POSITIONING.md`：核心主张、反常识判断、竞争性视角。
- `book-state.yaml`：章节状态、证据状态、输出状态和交付成熟度。
- `VISUAL_PLAN.md`：正文信息图、封面视觉、章节扉页和输出路径。
- `IMAGEGEN_BRIEF.md`：仅用于 `$imagegen` 位图视觉，不用于正文信息图。
- `src/INTRODUCTION.md`：读者可见开场。正式写作时删除模板标记，写入真实处境、问题重定义和阅读路径。

如果用户只给书名，先根据书名拟一版 brief，再指出缺口。不要把缺口脑补成事实。

`BOOK_BRIEF.md` 必须写清 `content_profile`、`voice_profile` 和 `voice_anchor`。书型决定结构，专家文风决定读者感受到“谁在说”，名人锚点负责把 Agent 快速拉进具体思考姿态。没有 voice profile 和 voice anchor，书会退化成资料汇编。

The rest: https://github.com/zjp1997720/zhijian-skills/blob/HEAD/skills/leadbook/SKILL.md