huangrichao2020 huashu-orange-book
用做一本书的方法快速搞懂一个陌生领域。核心不是出书，是用结构化方法对抗「不知道自己不知道什么」的发慌。
路由（先读再说）
如果用户说：
"我想做一本 X 的书 / 教程 / 指南 / 手册"
"快速搞懂 X 领域"
"扫盲 X"
"给团队做一份系统性 X 培训资料"
"出版社交稿用"
"EPUB / PDF / DOCX 出书"
"做橙皮书"
"做花叔那种带封面+目录的 PDF"
"领域入门"
→ 触发本 skill，按下面 5 阶段流程启动。
5 阶段流水线
| 阶段 | 做什么 | 核心产物 | 时间占比 |
|---|---|---|---|
| 1. 调研 | 6-10 维度并行 background agent | research/*.md |
30% |
| 2. 规划 | 写 PROJECT.md（章节大纲 + 调研索引 + agent 分工） | PROJECT.md |
10% |
| 3. 写作 | 多 agent 并行，每个 agent 先学风格 + 样本 | fragments/*.html |
30% |
| 4. 三审三校 + 事实核查 + 一致性审查 | 5 个 agent 并发审校 | 修复后的 fragments | 20% |
| 5. 构建 | PDF / DOCX / EPUB 3 套 pipeline | output/*.pdf/*.docx/*.epub |
10% |
5 道质量门（最关键）
- 内容/事实审校 — 时间线/工具对比/数据/人物归因
- 风格审校 — 去 AI 腔、加作者语感
- 细节打磨 — 句长 15-25 字、段 3-5 行、小标题 300-500 字一个
- 事实核查（独立怀疑者）— 强制 WebSearch 查一手源，质疑"前提成立吗"，修数字更要修论点
- 全书一致性审查 — 跨章节重复、观点冲突、术语不一致
第 4 道门独立于第 1 道门——因为写作者和审校者共用同一个模型知识库，错误会在同一个信息茧房里反复传播。事实核查员必须用 WebSearch，不能依赖模型记忆。
4 条底层原则
1. 结构先行 先给知识地图再填料，拒绝一上来甩链接/名词
2. 并行化 6-10 维度调研 + 多 agent 写作 + 3 个审校 agent 并发
3. 真入门 = 能讲清 强行逼你把领域讲清楚，「能讲清」才是入门判据
4. 事实优先于流畅 怀疑者独立核查一切事实声明，论点比数字更容易错
详细方法论位置
| 需要时读 | 位置 |
|---|---|
| 5 阶段全流程详解 | methodology/00-five-stage-pipeline.md |
| 并行调研细节 | methodology/01-research-parallel-agents.md |
| PROJECT.md 模板 | methodology/02-planning-project-doc.md |
| 风格学习 + 多 agent 写作 | methodology/03-writing-style-fusion.md |
| 5 道审校门详解 | methodology/04-five-quality-gates.md |
| PDF / DOCX / EPUB 构建 | methodology/05-build-pdf-docx-epub.md |
| Penguin 三段式封面 | methodology/06-cover-penguin-tri-band.md |
实战案例（9 本橙皮书）
| 书 | 领域 | case |
|---|---|---|
| Claude Code: The Complete Guide | 终端 AI 编程工具 | cases/case-01-claude-code.md |
| OpenAI Codex: The Complete Guide | OpenAI 编程工具 5 形态 | cases/case-02-codex.md |
| Hermes Agent 2.0: The Complete Guide | Nous Research 开源 Agent | cases/case-03-hermes-agent.md |
| Loop Engineering | 循环工程方法论 | cases/case-04-loop-engineering.md |
| Obsidian + Claude Code | 知识管理 + AI 集成 | cases/case-05-obsidian-ai.md |
| Harness Engineering | AI Agent 工具外壳 | cases/case-06-harness-engineering.md |
| Agent Skills: The Complete Guide | AI Skill 体系 | cases/case-07-agent-skills.md |
| Polymarket: The Complete Guide | 预测市场 | cases/case-08-polymarket.md |
| Claude Code: Source Code Analysis | Anthropic 510K 行源码 | cases/case-09-claude-code-source-analysis.md |
工具
工具脚本在 tools/（破例带代码）：
init-project.sh— bash 脚本，起项目骨架build.js— Node 脚本，fragments → 单页 HTMLbuild-pdf.js— Node 脚本 + Playwright，HTML → PDFupdate.sh— bash 脚本，版本管理 + 一键构建styles.css— 排版样式（12KB）
来源
本 skill 从花叔 alchaincyf 的 huashu-book-pdf skill 提炼。原 skill 完整版见 https://github.com/alchaincyf/nuwa-skill 的 examples 引用 + 花叔私域分发。
实战案例 9 本橙皮书仓库地址见 cases/00-cases-index.md。