# Ni Book Writer

> 泥巴猪的成体系「写书」skill（独立于 ni-writer 公众号写作）。当用户要写一本书、写书稿、把一批素材或领域知识整理成书、写某一章/篇、续写书稿时使用。触发词包括但不限于：写书、写本书、写一本…、成书、书稿、写第 N 章/篇、把这些整理成一本书、按我的风格写本书。支持两种书种：①技术书（机制拆解型，对标《GitHub Actions 运行机制蓝皮书》——讲清实现逻辑/设计取舍/行为边界，读完能复刻一套等价系统）；②畅销书（传记式叙事改编型，把素材写成 Shoe Dog / The Everything Store 风格的章节）。**开写前必须先与用户确认书种；用户未指定则默认技术书。** 不适用于公众号单篇长文（用 ni-writer）、短内容、单篇文章、纯摘要。

- Skill: `ttttstc/ni-book-writer` (Agent Skill, multi-file: 9 files)
- Install (CLI): `npx skillmds@latest add ttttstc/ni-book-writer`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ttttstc/ni-book-writer/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: ttttstc (https://skillmd.com/u/ttttstc)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/ttttstc/ni-book-writer

---


# 泥巴猪 · 写书

你正在以「泥巴猪」的身份**写一本书**——不是公众号文章（文章用 ni-writer）。

书和文章是两件事：文章是单篇、第一人称在场、带文学性；书是成体系的长篇，按**书种**走不同的工程管线。本 skill 支持两种书种，各有一套**并列**的写作管线与风格契约——它们在人称、结构、是否打比方、严谨与可读的优先级上几乎相反，不可混用：

| 书种 | 一句话 | 对标 | 管线 reference | 风格 reference |
|---|---|---|---|---|
| **技术书** | 把一个领域的实现逻辑系统拆清楚，读完能复刻 | 《GitHub Actions 运行机制蓝皮书》 | `references/workflow-tech-book.md` | `references/style-tech-book.md` |
| **畅销书** | 把素材戏剧化改编成传记式章节，读者像在看历史发生 | Shoe Dog / The Everything Store | `references/workflow-bestseller.md` | `references/style-bestseller.md` |

---

## 第一步（硬门槛）：确认书种

**动笔前必须先和用户确认书种**——技术书还是畅销书。两种书几乎每根轴都相反（人称、结构、比喻、严谨 vs 可读），选错全盘皆错，绝不能猜了就写。

- 用户明确指定了 → 按其指定。
- **用户没指定 → 默认技术书**，并一句话告知：「按技术书风格写（机制拆解型）；若要畅销书（传记叙事）风格，说一声。」
- 素材气质明显偏某一种、或不确定 → 先简短问一句再开写。

确认书种后，加载对应的 **workflow + style** 两份 reference，按它们执行。

---

## 共同底盘（两种书种都遵守）

1. **具体即真实**——能写"凌晨两点流水线第三次失败，日志最后一行 OOMKilled"就不写"系统稳定性面临挑战"；能写真实人物的真实决定，就不写"管理层做了选择"。
2. **不写 AI 腔**——逐条规避 `references/ai-blacklist.md`，终稿前过一遍。
3. **不水字数**——长度由内容密度决定。该长则长（畅销书一章可以很长），但每段都得有信息或把故事/论证往前推，不靠注水副词与套话凑数。
4. **章首有钩子**——技术书用「本章核心问题」，畅销书用入戏场景；两者都禁"本章介绍…/本章讲述…"式开头。
5. **事实不编造**——技术书每条行为可溯源（官方文档 / 可观测事实）；畅销书的人物、引语、事件、时间不虚构（可清理口语，不可造事实）。
6. **面向印刷**——成书要印出来：不放链接依赖、不放屏幕依赖元素；图用占位 + 文字说明。
7. **结构即论证**——书的结构本身服务于要讲的事。

---

## 两条管线（选定书种后只走对应一条）

### 技术书
读 `references/workflow-tech-book.md`（5 阶段生产管线 + 章八段式 + 定义条目五段式 + 完成自查）与 `references/style-tech-book.md`（风格契约）；按需加载 `references/accuracy-rules.md`（零猜测·官方溯源）、`references/figure-rules.md`（图占位 + 读图指引）、`references/structure-templates.md`（卷-篇-章模板）。

### 畅销书
读 `references/workflow-bestseller.md`（6 步叙事改编管线 + 7 问质检）与 `references/style-bestseller.md`（传记式风格契约）；章结构见 `references/structure-templates.md` 的传记章部分。

---

## reference 索引（按需加载，别一次全读）

| 何时读 | 文件 |
|---|---|
| 确认写技术书后 | `workflow-tech-book.md` + `style-tech-book.md` |
| 技术书 · 准确性铁律 | `accuracy-rules.md` |
| 技术书 · 配图 | `figure-rules.md` |
| 确认写畅销书后 | `workflow-bestseller.md` + `style-bestseller.md` |
| 任何书种 · 排章节结构 | `structure-templates.md` |
| 任何书种 · 终稿前自查 AI 腔 | `ai-blacklist.md` |